Django 1.8.x Documentation

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

摘要

文档介绍了Django 1.8版本的发布内容，包括新功能、向后兼容的更改、已删除的功能以及技术支持信息。此版本为Django的第二个长期支持（LTS）版本，保证了至少三年的安全更新支持，并明确指出了与Python版本的兼容性要求。新功能包括Model._meta API的正式化、多个模板引擎的支持，以及对Python 3.5的支持。同时，文档详细列出了已删除的旧功能，如django.contrib.comments模块和某些事务管理API，并强调了一些已弃用的功能。升级指南建议用户检查所有向后兼容的更改，并推荐了新旧API的迁移策略。

AI总结

以下是对《Django 1.8.x Documentation》的简要总结，重点突出核心观点和关键信息：

---

### **Django 1.8 版本亮点**
1. **LTS 版本**：Django 1.8 被指定为第二个“Long-Term Support”（长期支持）版本，将在发布后至少提供三年的安全更新。
2. **Python 兼容性**：
- 支持 Python 2.7、3.2、3.3、3.4 和 3.5。
- 这是首个支持 Python 3.5 的版本。
- 由于 Python 3.2 的上游支持结束，Django 1.8.x 在 2016 年底后将不再测试 Python 3.2 的兼容性。

---

### **新功能**
1. **Model._meta API 正式化**：
- Model._meta 现提供了正式的 API，用于检索和过滤字段，兼容旧 API 的同时逐步弃用非官方 API。
2. **多模板引擎支持**：
- 提供了更加灵活的模板引擎扩展能力。
3. **消息框架改进**：
- 新增了对多语言的支持，允许基于 LANGUAGES 设置生成sitemap。
4. **增强的安全性**：
- 修复了多个安全漏洞，包括会话存储的拒绝服务问题。

---

### **不兼容的改变**
1. **弃用和移除的功能**：
- 移除了 `django.contrib.comments`。
- 移除旧的交易管理 API，包括 `TransactionMiddleware` 和相关装饰器。
- 移除了 `SEND_BROKEN_LINK_EMAILS` 设置。
- 移除了 `cycle` 和 `firstof` 模板标签。
2. **URL 和模板相关改变**：
- 使用点式路径 (`dotted Python path`) 调用 `reverse()` 或设置 `LOGIN_URL` 和 `LOGIN_REDIRECT_URL` 将被移除。
- `django.conf.urls-patterns()` 和 `SimpleTestCase.urls` 被移除。
3. **管理命令变更**：
- 替换了旧的 `optparse` 和 `NoArgsCommand`，建议使用 `argparse` 和 `BaseCommand`。

---

### **删除的特性**
- 移除了多个已弃用的功能，包括：
- `django.db.models.sql.aggregates` 模块。
- `Model._meta.module_name` 别名。
- `BaseModelAdmin` 及相关类的向后兼容性代理。

---

### **Bug 修复和优化**
1. **1.8.1 版本更新**：
- 修复了多个迁移框架的问题，包括 `squashmigrations` 命令的兼容性。
- 支持序列化 `timedelta` 对象。
- 修复了与 MySQL 微秒支持相关的问题。
2. **1.8.4 版本更新**：
- 修复了.logout() 视图中的拒绝服务漏洞。
- 支持了 `UUIDField` 的序列化。
- 修复了查询集和迁移中的多个问题。

---

### **其他改进**
1. **缓存**：
- `LocMemCache` 后端的 `incr()` 方法现在是线程安全的。
2. **数据库支持**：
- MySQL 后端支持微秒精度。
3. **会话和站点管理**：
- 会话 cookie 在 `flush()` 后被删除。
- 默认站点创建时尊重 `SITE_ID` Setting。

---

### **总结**
Django 1.8 是一个重要的 LTS 版本，提供了长期支持，并引入了多项新功能和改进。升级时需注意不兼容的改变和移除的旧特性，并仔细检查代码以适应新的 API 和配置要求。