编写你的第一个 Django 应用,第 1 部分¶让我们通过示例来学习。 通过这个教程,我们将带着你创建一个基本的投票应用程序。 它将由两部分组成:
我们假定你已经阅读了 安装 Django。你能知道 Django 已被安装,且安装的是哪个版本,通过在命令提示行输入命令(由 $ 前缀)。 $ python -m django --version ...\> py -m django --version 如果这行命令输出了一个版本号,证明你已经安装了此版本的 Django;如果你得到的是一个“No module named django”的错误提示,则表明你还未安装。 这个教程是为了 Django 2.2 写的,它支持 Python 3.5 和后续版本。如果 Django 的版本不匹配,你可以通过页面右下角的版本切换器切换到对应你版本的教程,或更新至最新版本。如果你正在使用一个较老版本的 Python,在 我应该使用哪个版本的 Python 来配合 Django? 查找一个合适的 Django 版本。 你可以查看文档 如何安装 Django 来获得关于移除旧版本,安装新版本的流程和建议。 从哪里获得帮助: 如果你在阅读或实践本教程中遇到困难, 请发消息给 django-users 或加入 #django on irc.freenode.net 来和其他的 Django 用户交流,他们也许能帮到你。 创建项目¶如果这是你第一次使用 Django 的话,你需要一些初始化设置。也就是说,你需要用一些自动生成的代码配置一个 Django project —— 即一个 Django 项目实例需要的设置项集合,包括数据库配置、Django 配置和应用程序配置。 打开命令行, $ django-admin startproject mysite ...\> django-admin startproject mysite 这行代码将会在当前目录下创建一个 注解 你得避免使用 Python 或 Django 的内部保留字来命名你的项目。具体地说,你得避免使用像 我的代码该放在哪? 如果你曾经是原生 PHP 程序员(没有使用过现代框架),你可能会习惯于把代码放在 Web 服务器的文档根目录(诸如 把你的代码放在文档根目录 以外 的某些地方吧,比如 /home/mycode。 让我们看看 mysite/ manage.py mysite/ __init__.py settings.py urls.py wsgi.py 这些目录和文件的用处是:
用于开发的简易服务器¶让我们来确认一下你的 Django 项目是否真的创建成功了。如果你的当前目录不是外层的 $ python manage.py runserver ...\> py manage.py runserver 你应该会看到如下输出: Performing system checks... System check identified no issues (0 silenced). You have unapplied migrations; your app may not work properly until they are applied. Run 'python manage.py migrate' to apply them. 六月 11, 2019 - 15:50:53 Django version 2.2, using settings 'mysite.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C. 注解 忽略有关未应用最新数据库迁移的警告,稍后我们处理数据库。 你刚刚启动的是 Django 自带的用于开发的简易服务器,它是一个用纯 Python 写的轻量级的 Web 服务器。我们将这个服务器内置在 Django 中是为了让你能快速的开发出想要的东西,因为你不需要进行配置生产级别的服务器(比如 Apache)方面的工作,除非你已经准备好投入生产环境了。 现在是个提醒你的好时机:千万不要 将这个服务器用于和生产环境相关的任何地方。这个服务器只是为了开发而设计的。(我们在 Web 框架方面是专家,在 Web 服务器方面并不是。) 现在,服务器正在运行,浏览器访问 https://127.0.0.1:8000/。你将会看到一个“祝贺”页面,随着一只火箭发射,服务器已经运行了。 更换端口 默认情况下, 如果你想更换服务器的监听端口,请使用命令行参数。举个例子,下面的命令会使服务器监听 8080 端口: $ python manage.py runserver 8080 ...\> py manage.py runserver 8080 如果你想要修改服务器监听的IP,在端口之前输入新的。比如,为了监听所有服务器的公开IP(这你运行 Vagrant 或想要向网络上的其它电脑展示你的成果时很有用),使用: $ python manage.py runserver 0:8000 ...\> py manage.py runserver 0:8000 0 是 0.0.0.0 的简写。完整的关于开发服务器的文档可以在 :djamdin:`runserver` 参考文档中找到。 会自动重新加载的服务器 用于开发的服务器在需要的情况下会对每一次的访问请求重新载入一遍 Python 代码。所以你不需要为了让修改的代码生效而频繁的重新启动服务器。然而,一些动作,比如添加新文件,将不会触发自动重新加载,这时你得自己手动重启服务器。 创建投票应用¶现在你的开发环境——这个“项目” ——已经配置好了,你可以开始干活了。 在 Django 中,每一个应用都是一个 Python 包,并且遵循着相同的约定。Django 自带一个工具,可以帮你生成应用的基础目录结构,这样你就能专心写代码,而不是创建目录了。 项目 VS 应用 项目和应用有啥区别?应用是一个专门做某件事的网络应用程序——比如博客系统,或者公共记录的数据库,或者简单的投票程序。项目则是一个网站使用的配置和应用的集合。项目可以包含很多个应用。应用可以被很多个项目使用。 你的应用可以存放在任何 Python path 中定义的路径。在这个教程中,我们将在你的 请确定你现在处于 $ python manage.py startapp polls ...\> py manage.py startapp polls 这将会创建一个 polls/ __init__.py admin.py apps.py migrations/ __init__.py models.py tests.py views.py 这个目录结构包括了投票应用的全部内容。 编写第一个视图¶让我们开始编写第一个视图吧。打开 polls/views.py¶
from django.http import HttpResponse def index(request): return HttpResponse("Hello, world. You're at the polls index.") 这是 Django 中最简单的视图。如果想看见效果,我们需要将一个 URL 映射到它——这就是我们需要 URLconf 的原因了。 为了创建 URLconf,请在 polls 目录里新建一个 polls/ __init__.py admin.py apps.py migrations/ __init__.py models.py tests.py urls.py views.py 在 polls/urls.py¶
from django.urls import path from . import views urlpatterns = [ path('', views.index, name='index'), ] 下一步是要在根 URLconf 文件中指定我们创建的 mysite/urls.py¶
from django.contrib import admin from django.urls import include, path urlpatterns = [ path('polls/', include('polls.urls')), path('admin/', admin.site.urls), ] 函数 我们设计 何时使用 当包括其它 URL 模式时你应该总是使用 你现在把 $ python manage.py runserver ...\> py manage.py runserver 用你的浏览器访问 http://localhost:8000/polls/,你应该能够看见 "Hello, world. You're at the polls index." ,这是你在 没有找到页面? 如果你在这里得到了一个错误页面,检查一下你是不是正访问着http://localhost:8000/polls/ 而不应该是 http://localhost:8000/。 函数
|
|
来自: 宁静致远oj1kn5 > 《官网》