Django 1.8.x Documentation

• 语言: 英语
• 格式: .pdf
• 来源: media.readthedocs.org

摘要

该文档是Django 1.8.20.dev20180306181007版本的官方文档，由Django Software Foundation于2018年3月6日发布。文档内容涵盖Django的各个核心组成部分，包括模型层、视图层、模板层、表单、管理后台、安全、国际化、性能优化、Python兼容性等。文档详细介绍了Django 1.8版本的新特性，如模型元数据API（Model.__meta__）、多模板引擎支持（Django模板语言和Jinja2）、安全增强（SecurityMiddleware）、PostgreSQL特定功能（ArrayField、HStoreField等）、新数据类型（UUIDField和DurationField）、查询表达式和条件表达式等。此外，文档还包含部署指南、安全性检查清单、从旧API迁移的指南、安全更新记录（如CVE-2018-7536的拒绝服务漏洞修复）以及多个子版本的错误修复和优化内容。文档强调Python 2.7、3.2、3.3、3.4、3.5兼容性，并指出Django 1.8是第二个长期支持（LTS）版本。

AI总结

Django 1.8.x 文档总结

该文档是 Django 1.8.20.dev 版本的官方文档，发布于 2018年3月6日。Django 1.8 被指定为第二个长期支持（LTS）版本，安全更新周期至少为三年。

**主要内容结构：**
- **入门指南**：包含快速安装、创建第一个 Django 应用（分6部分）、编写可重用应用的高级教程等。
- **使用 Django**：涵盖安装、模型与数据库、HTTP 请求处理、表单、模板等核心主题。
- **参考**：提供详细的类、函数、方法等参考信息。
- **部署与安全**：包含部署指南和部署检查清单。
- **其他**：包括发布说明、内部文档等。

**Django 1.8 新特性：**

1. **Python 兼容性**：支持 Python 2.7、3.2、3.3、3.4、3.5。
2. **Model._meta API**：正式化 API，提供官方支持的字段检索和过滤方式。
3. **多模板引擎**：支持 Django 模板语言和 Jinja2，可在同一项目中使用多个引擎。
4. **安全增强**：集成了 `django-secure` 库的功能，新增 `SecurityMiddleware` 和 `--deploy` 检查选项。
5. **PostgreSQL 特定功能**：新增模块支持 ArrayField、HStoreField、Range Fields 等特性。
6. **新数据类型**：
- `UUIDField`：存储通用唯一标识符。
- `DurationField`：存储时间段（timedelta）。
7. **查询表达式**：支持复杂的 SQL 表达式、条件表达式（if...elif...else）以及数据库函数（Coalesce、Concat、Substr 等）。
8. **TestCase 数据设置**：新增 `setUpTestData()` 方法，支持在类级别初始化测试数据，提高测试速度。
9. **其他改进**：
- 管理后台 jQuery 升级至 1.9.1。
- 新增 `SuccessMessageMixin`。
- 表单集新增 `validate_max` 参数。
- 新增 `BCryptSHA256PasswordHasher` 解决 bcrypt 密码截断问题。
- Pillow 成为首选图像处理库，PIL 即将弃用。
- 新增 `QuerySet.first()` 和 `last()` 方法。

**关键安全修复（Django 1.8.19）：**
- 修复了 `urlize` 和 `urlizetrunc` 模板过滤器中的正则表达式灾难性回溯问题，该问题可导致拒绝服务（CVE-2018-7536）。

**弃用与移除：**
- 移除了 `django.contrib.comments` 和 `TransactionMiddleware`。
- 弃用了 `ssi` 模板标签、`if` 模板标签中的单等号比较、`GeoQuerySet` 聚合方法等。
- 数据库路由器的 `allow_migrate()` 方法签名已变更。