Django 4.2.2.dev20230512133603 文档

Home | Table of contents | Index | Modules

up | next »

Django 文档内容

• 开始
  • 初识 Django
    • 设计模型
    • 应用数据模型
    • 享用便捷的 API
    • 一个动态管理接口：并非徒有其表
    • 规划 URLs
    • 编写视图
    • 设计模板
    • 这仅是基本入门知识
  • 快速安装指南
    • 安装 Python
    • 设置数据库
    • 安装 Django
    • 验证
    • 搞定！
  • 编写你的第一个 Django 应用，第 1 部分
    • 创建项目
    • 用于开发的简易服务器
    • 创建投票应用
    • 编写第一个视图
  • 编写你的第一个 Django 应用，第 2 部分
    • 数据库配置
    • 创建模型
    • 激活模型
    • 初试 API
    • 介绍 Django 管理页面
  • 编写你的第一个 Django 应用，第 3 部分
    • 概况
    • 编写更多视图
    • 写一个真正有用的视图
    • 抛出 404 错误
    • 使用模板系统
    • 去除模板中的硬编码 URL
    • 为 URL 名称添加命名空间
  • 编写你的第一个 Django 应用，第 4 部分
    • 编写一个简单的表单
    • 使用通用视图：代码还是少点好
  • 编写你的第一个 Django 应用，第 5 部分
    • 自动化测试简介
    • 基础测试策略
    • 开始写我们的第一个测试
    • 测试视图
    • 当需要测试的时候，测试用例越多越好
    • 深入代码测试
    • 接下来要做什么？
  • 编写你的第一个 Django 应用，第 6 部分
    • 自定义 应用 的界面和风格
    • 添加一个背景图
  • 编写你的第一个 Django 应用，第 7 部分
    • 自定义后台表单
    • 添加关联的对象
    • 自定义后台更改列表
    • 自定义后台界面和风格
    • 自定义后台主页
  • Writing your first Django app, part 8
    • Installing Django Debug Toolbar
    • Getting help from others
    • Installing other third-party packages
    • 接下来要做什么？
  • 进阶指南：如何编写可重用程序
    • 可重用性很重要
    • 你的项目和可复用应用
    • 安装必须环境
    • 打包你的应用
    • 使用你自己的包名
    • 发布你的应用
    • 通过虚拟环境安装 Python 包
  • 下一步看什么
    • 查找文档
    • 文档是如何组成
    • 这个文档是如何更新的
    • 从哪里获取这个
    • 版本之间的差异
  • 编写你的第一个 Django 补丁
    • 介绍
    • 代码规范
    • 安装 Git
    • 获得一个 Django 开发版本的副本
    • 首先运行 Django 的测试套件
    • 尝试搞定一项新功能
    • 为你的补丁创建一个分支
    • 为你的工单写一些测试用例
    • 为你的工单编写代码
    • 第二次运行 Django 测试套件
    • 书写文档
    • 预览你的修改
    • 提交补丁中的修改
    • 推送这次提交并生成一个 pull 请求
    • 下一步
• 使用 Django
  • 如何安装 Django
    • 安装 Python
    • 安装 Apache 和 mod_wsgi
    • 运行你的数据库
    • 安装 Django 源码
  • 模型和数据库
    • 模型
    • 执行查询
    • 聚合
    • 搜索
    • 管理器
    • 执行原生 SQL 查询
    • 数据库事务
    • 多数据库
    • 表空间（Tablespaces）
    • 数据库访问优化
    • 数据库工具
    • 辅助工具
    • 模型关联 API 用法示例
  • 处理 HTTP 请求
    • URL调度器
    • 编写视图
    • 视图装饰器
    • 文件上传
    • Django 便捷函数
    • 通用视图
    • 中间件
    • 如何使用会话
  • 使用表单
    • HTML表单
    • Django在表单中的角色
    • Django 中的表单
    • 构建一张表单
    • 详解Django Form 类
    • 使用表单模板
    • 更多相关主题
  • 模板
    • Django 模板语言
    • 模板引擎的支持
  • 基于类的视图
    • 基于类的视图
    • 内置的基于类的通用视图
    • 使用基于类的视图处理表单
    • 在基于类的视图中使用混入
    • 基础示例
    • 在 URLconf 中的用法
    • 子类化通用视图
    • Asynchronous class-based views
  • 迁移
    • 命令
    • 后端支持
    • 工作流程
    • 事务
    • 依赖
    • 迁移文件
    • 向应用添加迁移
    • 撤销迁移
    • 历史模型
    • 删除模型字段时的注意事项
    • 数据迁移
    • 压缩迁移
    • 序列化值
    • 支持多个 Django 版本
  • 管理文件
    • 在模型中使用文件
    • File 对象
    • 文件存储
  • Django 中的测试
    • 编写并运行测试
    • 测试工具
    • 进阶测试主题
  • Django中的用户认证
    • 概况
    • 安装
    • 用法
  • Django 缓存框架
    • 设置缓存
    • 站点缓存
    • 视图缓存
    • 模板片段缓存
    • 底层缓存 API
    • 异步支持
    • 下游缓存
    • 使用 Vary 标头
    • 使用其他标头控制高速缓存
    • MIDDLEWARE 顺序
  • 条件视图处理
    • 条件装饰器
    • 仅用于计算一个值的快捷方式
    • 将装饰器和其他 HTTP 方法一起使用
    • 对比中间件的条件处理
  • 加密签名
    • Protecting SECRET_KEY and SECRET_KEY_FALLBACKS
    • 使用低级 API
  • 发送邮件
    • 快速上手
    • send_mail()
    • send_mass_mail()
    • mail_admins()
    • mail_managers()
    • 示例
    • 防止头注入
    • EmailMessage 类
    • 邮件后端
    • 为了开发配置邮件
  • 国际化和本地化
    • 概况
    • 定义
  • 日志
    • 概况
    • Security implications
    • 日志模块的配置
  • 分页
    • Paginator 类
    • 例如
    • ListView 分页
    • 在视图函数中使用 Paginator
  • Django 的安全性
    • 防御跨站脚本攻击（XSS）
    • 防御跨站点请求伪造（CSRF）
    • 防御 SQL 注入
    • 防御访问劫持
    • SSL/HTTPS
    • Host 头部验证
    • Referrer 策略
    • 跨源弹出式窗口策略
    • 会话安全
    • 用户上传内容
    • 其他安全性相关主题
  • 性能和优化
    • 介绍
    • 一般方法
    • 缓存
    • 理解惰性
    • 数据库
    • HTTP 性能
    • 模板性能
    • 使用现有软件的不同版本
  • 序列化 Django 对象
    • 序列化数据
    • 反序列化数据
    • 序列化格式
    • 自然键
  • Django 配置
    • 基础
    • 指定配置文件
    • 默认配置
    • 在 Python 代码中使用 settings
    • 运行时更改设置
    • 安全
    • 可用的配置项
    • 创建你自己的配置文件
    • 不设置 DJANGO_SETTINGS_MODULE 时使用配置
  • 信号
    • 监听信号
    • 定义和发送信号
    • 断开信号
  • 系统检查框架
    • 编写自定义的检查
  • 扩展包
    • Localflavor
    • Comments
    • Formtools
  • 异步支持
    • 异步视图
    • 异步安全
    • 异步适配函数
• 操作指南
  • 使用 REMOTE_USER 进行身份验证
    • 配置
    • 仅在登录界面使用 REMOTE_USER
  • 如何使用 Django 提供的 CSRF 防护功能
    • 通过 AJAX 进行 CSRF 防护
    • 在 Jinja2 模板中使用 CSRF 防护
    • 在装饰器方法中使用
    • 处理被拒绝的请求
    • 通过缓存进行 CSRF 防护
    • CSRF 防护与测试
    • 边缘案例
    • 在可复用应用中使用 CSRF 保护。
  • 编写自定义 django-admin 命令
    • 接受可选参数
    • 管理命令和本地化
    • 测试
    • 覆盖命令
    • 命令对象
  • 编写自定义模型字段
    • 介绍
    • 背后的理论
    • 编写一个 field 子类
    • 编写一个 FileField 子类
  • 如何编写自定义的查询器
    • 一个查询器示例。
    • 一个转换器示例。
    • 编写一个高效的 abs__lt 查找
    • 一个双向转换器示例
    • 为现有的查找编写代替实现
    • Django 是如何取舍查询器和转换器的
  • 如何编写一个自定义的模板后端
    • 自定义后端
    • 为自定义引擎集成调试功能
  • 如何编写自定义的模板标签和过滤器
    • 代码布局
    • 编写自定义的模板过滤器
    • 编写自定义模板标签
  • 如何编写一个自定义的文件存储类
    • Use your custom storage engine
  • 如何部署 Django
    • 如何使用 WSGI 进行部署
    • 如何使用 ASGI 来部署
    • 部署清单
  • 如何将 Django 更新至新的版本
    • 必读内容
    • 依赖
    • 处理过期警告
    • 安装
    • 测试
    • 部署
  • 如何管理错误报告
    • 通过邮件方式报告
    • 过滤错误报告
  • 如何为模型提供初始数据
    • Provide initial data with migrations
    • Provide data with fixtures
  • 如何将 Django 与旧有的数据库集成
    • 将数据库参数告诉 Django
    • 自动生成这些模型
    • 安装核心 Django 表
    • 测试和调整
  • 如何配置和使用日志
    • 发起基本的 logging 调用
    • 自定义日志配置
  • 如何输出 CSV
    • 使用 Python 的 CSV 库
    • 使用模板系统
    • 其它文本格式
  • 如何创建 PDF 文件
    • 安装 ReportLab
    • 编写视图
    • 其它格式
  • 如何覆盖模板
    • 重写来自工程目录的模板
    • 重写来自应用模板目录的模板
    • 扩展复写模板
  • 如何管理静态文件（如图片、JavaScript、CSS）
    • 配置静态文件
    • 开发时提供静态文件服务
    • 开发期间保存用户上传的文件
    • 测试
    • 部署
    • 了解更多
  • 如何部署静态文件
    • 在生产环境提供静态文件服务
    • 了解更多
  • 如何在 Windows 上安装 Django
    • 安装Python
    • 关于 pip
    • 配置一个虚拟环境
    • 安装 Django
    • 彩色终端输出
    • 常见失误
  • 如何创建数据库迁移
    • 数据迁移和多种数据库
    • 添加独一无二字段的迁移
    • 控制迁移顺序
    • 在第三方应用程序中迁移数据
    • 通过使用 through 模型来更改 ManyToManyField 字段。
    • 将非托管模型变为托管的
• Django FAQ
  • FAQ：概述
    • 这个项目因何存在。
    • “Django”是什么意思，怎么发音？
    • Django 稳定吗?
    • Django 可扩展吗?
    • 谁在这背后？
    • Django 是如何授权的？
    • 为什么 Django 包含 Python 的协议文件？
    • 哪些站点使用 Django?
    • Django 似乎是一个 MVC 框架，但是您将控制器称为“视图”，并视图称为“模板”。 为什么不使用标准命名？
    • <Framework X>可以做到<feature Y>--为什么 Django 不能呢？
    • 为什么你要从头开始写所有的 Django 项目，而不是使用其他 Python 库？
    • Django 是个内容管理系统(CMS)吗?
    • 我如何下载 Django 文档进行离线阅读？
    • 如何引用 Django？
  • FAQ：安装
    • 如何开始？
    • 使用 Django，需要做好什么准备？
    • 我应该使用哪个版本的 Python 来配合 Django?
    • 我应该选用什么版本的 Python 来使用 Django ？
    • 我应该使用稳定版本还是开发版本？
  • FAQ: 使用Django
    • 为什么我在导入 DJANGO_SETTINGS_MODULE 时收到错误提示？
    • 我不喜欢 Django 的模板语言，能不能不使用它？
    • 我是否必须使用你的模型/数据库层？
    • 我要怎么使用图片和文件字段？
    • 我如何让一个变量可用于我的所有模板之中？
  • FAQ：获取帮助
    • 我该如何做 X？Y为什么不工作？我可以去哪里寻求帮助？
    • 为什么我的信息没有出现在 django-users 上面呢？
    • 没有人回答我的问题！我应该怎么办呢？
    • 我认为我找到了个 bug！我应该做什么呢？
    • 我认为我已经发现了个安全问题！我应该做什么？
  • FAQ：数据库和模型
    • 我该如何在Django运行的过程中看到SQL查询？
    • 我可以让 Django 使用一个已经存在的数据库吗？
    • 如果我对一个模型做了改动，我该如何去更新数据库？
    • Django 支持多列主键吗？
    • Django 支持 NoSQL 数据库吗？
    • 如何将特定于数据库的选项添加到我的 CREATE TABLE 语句中，例如将 MylSAM 指定为表类型？
  • FAQ：管理
    • 无法登录。当我输入有效的用户名和密码后，页面再跳转到登录页面，没有显示任何错误信息。
    • 我无法登陆。当我输入有效的用户名和密码后，它又跳转到了登录界面，并且显示一个“请输入正确的用户名和密码”的错误。
    • 在管理面板中，如何将字段的值自动设置为最后编辑它的用户？
    • 我们如何设定管理权限，以便对象只能由创建它们的用户进行编辑？
    • 管理界面的 CSS 和图片在开发模式下正常加载，但是在使用 mod_wsgi 进行部署的情况下却无法进行加载？
    • 我的“list_filter”包含一个 ManyToManyField (多对多字段)，但过滤器不显示
    • 有些对象没有在管理中出现。
    • 如何个性化管理员后台接口的功能？
    • 动态生成的管理页面太丑了。我该怎么换掉它？
    • Admin 适配了哪些浏览器？
  • FAQ：贡献代码
    • 如何为 Django 贡献代码?
    • 我几周之前提交了一个工单系统 bug 的修复。为什么忽略我的提议？
    • 何时以及如何提醒团队我所关注的补丁？
    • 但是我已经提醒你好几遍了，你依然继续忽略我的补丁！
    • 我肯定我的工单百分之100绝对完成了，那么就能说我把这个工单认定为 ”通过批准" 了吗？
  • 错误调试
    • 运行 django-admin 时遇到的问题
    • 杂项
• API 参考
  • 应用程序
    • 项目和应用程序
    • 配置应用程序
    • 应用程序配置
    • 应用程序注册表
    • 初始化进程
  • 系统检查框架
    • API 参考
    • 内置标签
    • 核心系统检查
    • contrib 应用检查
  • 内置基于类的视图 API
    • 基础视图
    • 通用显示视图
    • 通用编辑视图
    • 通用日期视图
    • 基于类的视图混入
    • 基于类的通用视图——扁平化索引
    • 规范
    • 基础 vs 通用视图
  • 点击劫持保护
    • 点击劫持的一个例子
    • 防止点击劫持
    • 如何使用它
    • 限制
  • contrib 包
    • Django 管理站点
    • django.contrib.auth
    • 内容类型框架
    • 简单页面应用
    • GeoDjango
    • django.contrib.humanize
    • 消息框架
    • django.contrib.postgres
    • 重定向应用
    • 站点地图框架
    • “站点”框架
    • staticfiles 应用
    • Feed 聚合框架
    • admin
    • auth
    • contenttypes
    • flatpages
    • gis
    • humanize
    • messages
    • postgres
    • redirects
    • sessions
    • sites
    • sitemaps
    • syndication
    • 其他附加功能
  • 跨站请求伪造保护
    • 工作方式
    • 限制
    • 实用程序
    • 配置
    • 常问问题
  • 数据库
    • 通用注意事项
    • PostgreSQL 注意事项
    • MariaDB 注意事项
    • MySQL 注意事项
    • SQLite 注意事项
    • Oracle 注意事项
    • 子类化内置数据库后端
    • 使用第三方数据库后端
  • django-admin 和 manage.py
    • 用法
    • 可用命令
    • 应用程序提供的命令
    • 默认选项
    • 额外的细节
  • 从你的代码中运行管理命令
    • 输出重定向
  • Django 异常
    • Django 核心异常
    • URL 解析器异常
    • 数据库异常
    • HTTP 异常
    • 会话异常
    • 事务异常
    • 测试框架异常
    • Python 异常
  • 文件处理
    • File 对象
    • 文件存储 API
    • 上传的文件和上传处理程序
  • 表单
    • 表单 API
    • 表单字段
    • 模型表单函数
    • 表单集函数
    • 表单渲染 API
    • 部件
    • 表单和字段验证
  • 日志
    • Django 的默认日志配置
    • Django logging extensions
  • 中间件
    • 可用的中间件
    • 中间件顺序
  • 迁移操作
    • 架构操作
    • 特殊操作
    • 自己写
  • 模型
    • 模型字段参考
    • 字段属性参考
    • 模型索引参考
    • 约束参考
    • 模型 _meta API
    • 关联对象参考
    • 模型类参考
    • 模型 Meta 选项
    • 模型实例参考
    • QuerySet API 参考
    • 查找 API 参考
    • 查询表达式
    • 条件表达式
    • 数据库函数
  • 分页器
    • Paginator 类
    • Page 类
    • 异常
  • 请求和响应对象
    • 快速概述
    • HttpRequest 对象
    • QueryDict 对象
    • HttpResponse 对象
    • JsonResponse 对象
    • StreamingHttpResponse 对象
    • FileResponse 对象
    • HttpResponseBase class
  • SchemaEditor
    • 方法
    • 属性
  • 配置
    • 核心配置
    • 认证
    • 消息
    • 会话
    • 站点
    • 静态文件
    • 核心配置专题索引
  • 信号
    • 模型信号
    • 管理信号
    • 请求／响应信号
    • 测试信号
    • 数据库包装器
  • 模板
    • Django 模板语言
    • 内置模板标签和过滤器
    • Django 模板语言：对于 Python 开发者
  • TemplateResponse 和 SimpleTemplateResponse
    • SimpleTemplateResponse 对象
    • TemplateResponse 对象
    • 渲染过程
    • 使用 TemplateResponse 和 SimpleTemplateResponse
  • Unicode 数据
    • 创建数据库
    • 一般字符串处理
    • 模型
    • 模板
    • 文件
    • 表单提交
  • django.urls 实用函数
    • reverse()
    • reverse_lazy()
    • resolve()
    • get_script_prefix()
  • URLconfs 中使用的 django.urls 函数
    • path()
    • re_path()
    • include()
    • register_converter()
  • URLconfs 中使用的 django.conf.urls 函数
    • static()
    • handler400
    • handler403
    • handler404
    • handler500
  • Django 实用程序
    • django.utils.cache
    • django.utils.dateparse
    • django.utils.decorators
    • django.utils.encoding
    • django.utils.feedgenerator
    • django.utils.functional
    • django.utils.html
    • django.utils.http
    • django.utils.module_loading
    • django.utils.safestring
    • django.utils.text
    • django.utils.timezone
    • django.utils.translation
  • 验证器
    • 编写验证器
    • 如何运行验证器
    • 内置验证器
  • 内置视图
    • 为开发中的文件提供服务
    • 错误视图
• 元文件和杂记
  • API 的稳定性
    • 什么是“稳定”？
    • 稳定的 API
    • 例外
  • 设计理念
    • 总体
    • 模型
    • 数据库API
    • URL 设计
    • 模板系统
    • 视图
    • 缓存框架
  • Django 的第三方发布包
    • 对于发布者
• 术语
• 发行说明
  • 最终版本
    • 4.2 release
    • 4.1 release
    • 4.0 release
    • 3.2 发行
    • 3.1 发行
    • 3.0 发行
    • 2.2 发行
    • 2.1 发行
    • 2.0 发行
    • 1.11 发行
    • 1.10 发行
    • 1.9 发行
    • 1.8 发行
    • 1.7 发行
    • 1.6 发行
    • 1.5 发行
    • 1.4 发行
    • 1.3 发行
    • 1.2 发行
    • 1.1 发行
    • 1.0 发行
    • 1.0 前发行
  • 安全发行
• Django internals
  • 为 Django 做贡献
    • Django 框架的工作
    • 加入 Django 社区 ❤️
  • Mailing lists and Forum
    • Django Forum
    • django-users
    • django-developers
    • django-announce
    • django-updates
  • Organization of the Django Project
    • Principles
    • Mergers
    • Releasers
    • Steering council
    • Changing the organization
  • Django 的安全策略
    • 报告安全问题
    • 支持的版本
    • Django 如何披露安全问题
    • Who receives advance notification
    • Requesting notifications
  • Django 的发行流程
    • 正式发行
    • 发行节奏
    • 废弃政策
    • 支持的版本
    • 发行过程
  • Django废弃时间表
    • 5.1
    • 5.0
    • 4.1
    • 4.0
    • 3.1
    • 3.0
    • 2.1
    • 2.0
    • 1.10
    • 1.9
    • 1.8
    • 1.7
    • 1.6
    • 1.5
    • 1.4
    • 1.3
  • Django源代码库
    • 高级概述
    • The main branch
    • Stable branches
    • 标签(Tags)
  • How is Django Formed?
    • 概况
    • Prerequisites
    • Pre-release tasks
    • Preparing for release
    • Actually rolling the release
    • Making the release(s) available to the public
    • Post-release
    • New stable branch tasks
    • Notes on setting the VERSION tuple

索引和词汇表

• 索引
• 模块索引
• 术语

Last update:

5月 12, 2023

up | next »