Install Django Guide

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/qq_29757283/article/details/82558022

Install Django Guide

Django 安装向导（和使用入门）

Overview

Summary

Install

Windows platform

C:\ > pip -V
pip 18.0 from ....\pip (python 3.5)
C:\ > pip install Django==2.1.1 -i https://pypi.tuna.tsinghua.edu.cn/simple/
C:\ > ## 2.1.1 is latest for now(Sep/08/2018)
C:\ > python -V
Python 3.5.2
C:\ > python
...
>>> import django
>>> django.get_version()
'2.1.1'
>>> exit()
C:\ >

Linux Platform (Debian)

$ reserve place

ToDo

-[o] N/A

Note

n/a

Django 和 Python 版本关系

Django version	Python version
1.8	2.7, 3.2, 3.3, 3.4, 3.5
1.9, 1.19	2.7, 3.2, 3.5
1.11	2.7, 3.4, 3.5, 3.6
2.0	3.5+

Reference:

runoob Django 教程

Detail（正文）

Sep/08 - 安装和启用

–:– - 创建 Django 目录， 基本文档 - README etc…

创建本 Developer/Install_Django.md 文档！

新增内容： Note->Django 和 Python 版本关系

–:– - 安装和测试安装

C:\ > pip -V
pip 18.0 from ....\pip (python 3.5)
C:\ > pip install Django==2.1.1 -i https://pypi.tuna.tsinghua.edu.cn/simple/
C:\ > ## 2.1.1 is latest for now(Sep/08/2018)
C:\ > python -V
Python 3.5.2
C:\ > python
...
>>> import django
>>> django.get_version()
'2.1.1'
>>> exit()
C:\ >

–:– - 开始一个简单的 project

django book

开始一个项目
一但你安装好了python，django和（可选的）数据库及相关库，你就可以通过创建一个project，迈出开发django应用的第一步。

> ## 新建一个目录 ## 
D:\Django\ > 
D:\Django\ > mkdir keepPSWD
D:\Django\ > cd keepPSWD
D:\Django\keepPSWD\ > ## 使用 Django 创建 project ##
D:\Django\keepPSWD\ > django-admin.exe startproject PyAPP
D:\Django\keepPSWD\ > dir
...
 Directory of D:\Django\keepPSWD
 09/08/2018  17:44    <DIR>          .
 09/08/2018  17:44    <DIR>          ..
 09/08/2018  17:44    <DIR>          PyAPP
               0 File(s)              0 bytes
               3 Dir(s)  16,025,001,984 bytes free
D:\Django\keepPSWD\ > tree ## cygwin - linux command
keepPSWD
    └── PyAPP
        ├── PyAPP
        │   ├── __init__.py
        │   ├── settings.py
        │   ├── urls.py
        │   └── wsgi.py
        └── manage.py

D:\Django\keepPSWD\ > cd PyAPP
D:\Django\keepPSWD\PyAPP > python manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).

You have 15 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
September 08, 2018 - 17:58:52
Django version 2.1.1, using settings 'PyAPP.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.
_
### my comment:
# 运行 浏览器， http://127.0.0.1:8000/ 查看 django 一个内建的，轻量的web服务。

line 6: 运行 django-admin.py 注意事项

there are django-admin.exe can be running.
## 笔者的 Python35\Script\ 已经加过了 Windows 环境变量中。

line 7~24 - 使用 django-admin 创建的 project 下的文件内容解释：

__init__.py ：让 Python 把该目录当成一个开发包 (即一组模块)所需的文件。 这是一个空文件，一般你不需要修改它。

manage.py ：一种命令行工具，允许你以多种方式与该 Django 项目进行交互。 键入python manage.py help，看一下它能做什么。 你应当不需要编辑这个文件；在这个目录下生成它纯是为了方便。

settings.py ：该 Django 项目的设置或配置。 查看并理解这个文件中可用的设置类型及其默认值。

urls.py：Django项目的URL设置。 可视其为你的django网站的目录。 目前，它是空的。

line 27~42 - 启动开发阶段的 django 内置 web server

Web server build-in django whitch enabled by python manage.py runserver

Django Book

在进一步学习之前， 一个重要的，关于开发网络服务器的提示很值得一说。 虽然 django 自带的这个 web 服务器对于开发很方便，但是，千万不要在正式的应用布署环境中使用它。 在同一时间，该服务器只能可靠地处理一次单个请求，并且没有进行任何类型的安全审计。 发布站点前，请参阅第 20 章了解如何部署 Django 。

更改这个 Development Server 的主机地址或端口

默认情况下， runserver 命令在 8000 端口启动开发服务器，且仅监听本地连接。 要想要更改服务器端口的话，可将端口作为命令行参数传入：

python manage.py runserver 8080

通过指定一个 IP 地址，你可以告诉服务器–允许非本地连接访问。 如果你想和其他开发人员共享同一开发站点的话，该功能特别有用。 0.0.0.0 这个 IP 地址，告诉服务器去侦听任意的网络接口。

python manage.py runserver 0.0.0.0:8000

完成这些设置后，你本地网络中的其它计算机就可以在浏览器中访问你的 IP 地址了。比如：http://192.168.1.103:8000/ . (注意，你将需要校阅一下你的网络配置来决定你在本地网络中的IP 地址) Unix用户可以在命令提示符中输入ifconfig来获取以上信息。 使用Windows的用户，请尝试使用 ipconfig 命令。

Sep/08 - Hello World

–:– - 简单 Hello World 实例

D:\Django\keepPSWD\PyAPP > dir
 ...  <DIR>  .
 ...  <DIR>  ..
 ...         db.sqlite3
 ...         manage.py
 ...  <DIR>  PyAPP
 .....
D:\Django\keepPSWD\PyAPP > cd PyAPP
D:\Django\keepPSWD\PyAPP\PyAPP > dir
  .....
  ...            settings.py
  ...            urls.py
  ...            wsgi.py
  ...            __init__.py
  ...   <DIR>    __pycache__
D:\Django\keepPSWD\PyAPP\PyAPP > type nul>views.py
D:\Django\keepPSWD\PyAPP\PyAPP > views.py  
   ## windows 下设置 *.py 文件和编辑器关联。则执行该命令就会使用编辑器打开 views.py
D:\Django\keepPSWD\PyAPP\PyAPP > type views.py  ## 下面内容省略了无关代码
#!/usr/bin/env python3
from django.http import HttpResponse

def hello(request):
        return HttpResponse("Hello World!")

D:\Django\keepPSWD\PyAPP\PyAPP > urls.py
  ## 编辑 urls.py ##
D:\Django\keepPSWD\PyAPP\PyAPP > type urls.py   ## 下面内容省略了无关代码
from django.contrib import admin
from django.urls import path

from .views import hello

urlpatterns = [
    path('admin/', admin.site.urls),
    path('hello/', hello),
]
D:\Django\keepPSWD\PyAPP\PyAPP > 

基于上一节 manage.py runserver 正在运行

然后做了上述代码的修改之后， 在浏览器中，输入 http://127.0.0.1:8000/hello/

注意：Django book 上的教程较老，但当前并非使用正则表达式在 urls.py 中

path(r'^hell/$', hello),

当前 hello world 实例并非严谨的 MVC 实例。MVC(MTV) 还需更进一步。

Reference:
1. Django book
2. runoob Django 教程