一. 安装 django
$ pip install django
(env)$ python
>> import django
>> django.VERSION
>> django.get_version()
二. 项目结构
$ django-admin.py startproject mysite . # 注意后面的 '点' .
$ tree
mysite/
├── manage.py
└── mysite
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
$ python manage.py runserver 8000 # 启动服务器.
文件职责介绍:
urls.py : 网址入口,关联到对应的 views.py 的中的一个函数(或generic类),访问网址对应一个函数.
views.py : 处理用户发出的请求, 从 urls.py 中对应过来, 通过渲染 templates 中的网页可以将显示的内容.
models.py : 与数据库操作有关,存入或存取数据时使用,可以不用.
forms.py : 表单,用户在浏览器上输入数据提交,对数据的验证工作以及输入框的生成等工作,可以不用.
templates 文件夹 : views.py 中的函数渲染 templates 中的html模板,得到动态内容网页,可用缓存来提升速度.
admin.py : 后台,可以用少量的代码,拥有一个强大的后台.
settings : Django的设置,配置文件,比如 DEBUG 开关,静态文件的位置等.
每个视图函数至少需要一个参数, 通常叫做 request , 这是一个触发这个视图, 包含当前 web 请求信息的对象, 是类 django.http.HttpRequest 的一个实例.
一个视图就是 Python 的一个函数, 这个函数第一个参数的类型是 HttpRequest, 它返回一个 HttpResponse 实例, 为了使一个 Python 的函数成为一个 Django 可识别的函数, 它必须满足这两个条件.
三. 命令汇总
# 新建一个 django project
$ django-admin.py startproject PROJECT_NAME
# 新建 app
$ python manage.py startapp APP_NAME
$ django-admin.py startapp APP_NAME # 同上
** 一般一个项目有多个app,当然通用的app也可以在多个项目中使用
# 同步数据库
$ python manage.py syncdb
** 当 Django 1.7.1 及以上版本需使用以下命令:
$ python manage.py makemigrations
$ python manage.py migrate
** 这种方法可以创建表,当你在 models.py 中新增了类时,运行它就可以自动在数据库中创建表了,不用手动创建.
** 对已有的 models 进行修改,Django 1.7 之前的版本的Django都是无法自动更改表结构的, 不过有第三方工具 south
# 使用开发服务器 :
开发服务器,即开发时使用,一般修改代码后会自动重启,方便调试和开发,但是由于性能问题,建议只用来测试,不要用在生产环境。
$ python manage.py runserver
$ python manage.py runserver 8001
$ python manage.py runserver 0.0.0.0:8000
# 清空数据库 :
$ python manage.py flush # 会询问 yes 还是 no. yes 会把数据全部清空,只留下空表.
# 创建超级管理员 :
$ python manage.py createsuperuser # 用户名,密码必填,邮箱可留空.
$ python manage.py changepassword username # 修改用户密码.
# 导入导出数据
$ python manage.py dumpdata appname > appname.json
$ python manage.py loaddata appname.json
# Django 项目环境终端.
$ python manage.py shell # 如果你安装了 bpython 或 ipython 会自动用它们的界面,推荐安装 bpython。
** 这个命令和 直接运行 python 或 bpython 进入 shell 的区别是:你可以在这个 shell 里面调用当前项目的 models.py 中的 API,对于操作数据,还有一些小测试非常方便。
# 数据库命令行
$ python manage.py dbshell
Django 会自动进入在settings.py中设置的数据库,如果是 MySQL 或 postgreSQL,会要求输入数据库用户密码。
在这个终端可以执行数据库的SQL语句。
# 更多命令 :
$ python manage.py # 查看命令列表.
$ python manage.py help <subcommand>
# 获取帮助 :
$ python manage.py --help
$ python manage.py help [SUB_CMD]
# 后台管理密码
$ python manage.py createsuperuser
user : admin
password : 123456
$ curl http://example.com/admin