Django 2.2.x Documentation

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

摘要

Django 2.2是一个长期支持版本，引入了新的数据库约束功能，改进了模型验证和ORM，修复了多个安全性和性能问题，并移除了部分已弃用的特性。该版本支持Python 3.5到3.9，并提供了更高的灵活性和性能优化。

AI总结

《Django 2.2.x Documentation》总结如下：

### 核心内容概述

1. **Django 2.2 版本特性**
- **长期支持（LTS）**：Django 2.2 是一个长期支持版本，自发布之日起将获得至少三年的安全更新支持。
- **Python 兼容性**：支持 Python 3.5、3.6、3.7、3.8（自 2.2.8 起）和 3.9（自 2.2.17 起）。
- **新功能**：
- **数据库约束**：新增 `CheckConstraint` 和 `UniqueConstraint` 类，允许在模型中添加自定义数据库约束。
- **强制 INSERT/UPDATE**：模型 `save()` 方法新增参数，可强制执行 INSERT 或 UPDATE 操作。
- **Jython 兼容性**：支持即将发布的 Jython 2.5。
- **缓存中间件改进**：将 `CacheMiddleware` 拆分为两个独立中间件，分别处理缓存插入和读取。

2. **重要改进**
- **CSRF 保护增强**：显著提升了跨站请求伪造（CSRF）的防护能力。
- **模板系统优化**：新增“智能”模板标签 `if`，支持比较运算符。
- **邮件发送扩展**：通过邮件后端实现更灵活的邮件发送配置。

3. **已知问题与修复**
- **修复的 bug**：
- 解决了 Oracle 数据库密码引用问题（#30307）。
- 修复了技术 500 调试页面模板加载崩溃问题（#30324）。
- 解决了 `ArrayAgg` 和 `StringAgg` 的排序参数问题（#30332）。
- 修复了 `makemigrations` 生成无限迁移的问题（#30350）。
- 解决了 `Paginator` 在特定查询集下的崩溃问题（#30335）。
- 修复了 `IntegerField` 验证问题（#30328）。
- 优化了 `SearchVector` 的索引生成问题（#30385）。
- **已知问题**：
- 部分功能可能因兼容性问题导致行为变化，需参考升级指南。

4. **弃用特性**
- **移除的模块**：
- `django.contrib.comments` 模块已移除。
- `django.db.backends.postgresql_psycopg2` 模块已移除。
- **弃用的功能**：
- `DEFAULT_CONTENT_TYPE` 和 `FILE_CHARSET` 设置不再支持。
- `django.shortcuts.render_to_response()` 已移除。
- `HttpRequest.xreadlines()` 已移除。
- `RemoteUserBackend.configure_user()` 需要 `request` 作为第一个参数。

5. **文档结构**
- 提供了详细的版本更新日志，包括从 Django 2.2 到后续版本的所有修复和改进。
- 包含了开发者贡献指南、安全策略和项目组织原则等内部文档。

### 总结
Django 2.2 是一个功能丰富、稳定性强的版本，适合需要长期维护和更新的项目。其新功能和改进显著提升了开发效率和系统安全性，同时修复了多个关键问题，确保了与旧版本的兼容性。建议升级用户仔细阅读升级指南，确保平滑过渡。