Django 5.1 Documentation

• 语言: 英语
• 格式: .epub

摘要

Django 5.1版本文档介绍了该版本的主要更新内容，包括移除对PostgreSQL 12、MariaDB 10.4等旧版本数据库的支持，新增了{% querystring %}模板标签以简化URL查询参数的处理，并改进了admin界面的可访问性。文档还列出了多项功能的移除和弃用，以及对旧版本功能的不兼容更改。

AI总结

### Django 5.1 版本更新总结

#### 1. **不兼容更改**
- **数据库支持**：
- 移除了对PostGIS 2.5、GDAL 2.4和MariaDB 10.4的支持。
- PostgreSQL 12不再受支持，最低要求为PostgreSQL 13。
- GeoIP2不再同时打开城市和国家数据库，优先使用城市数据库，国家数据库需显式指定路径。

- **功能移除**：
- 移除了`ESMeta`别名、`get_prefetch_queryset()`方法、`FORMS_URLFIELD_ASSUME_HTTPS`过渡设置、`ModelAdmin.log_deletion()`和`LogEntryManager.log_action()`方法。
- 移除了`django.utils.itercompat.is_iterable()`函数和`django.utils.itercompat`模块。
- 移除了`BaseUserManager.make_random_password()`方法、`Meta.index_together`选项、`length_is`模板过滤器等。

#### 2. **新功能**
- **模板标签**：引入了`{% querystring %}`模板标签，简化URL查询参数的修改。
- **可访问性改进**：
- 管理界面的过滤器、页脚和折叠组件使用了新的HTML标签（``、``、``、``）。
- 移除了不再需要的JavaScript文件`collapse.js`。
- **性能优化**：
- `Truncator`类现在使用`html.parser.HTMLParser`子类，提升了稳定性和性能。

#### 3. **其他改进**
- **Python兼容性**：Django 5.1支持Python 3.10、3.11和3.12。
- **视图处理**：增强了对ETag和Last-Modified头的支持，优化了条件视图处理。
- **URL命名空间**：改进了URL命名空间功能，支持更灵活的URL路由。

#### 4. **移除的特性**
- **密码哈希器**：移除了`SHA1PasswordHasher`、`UnsaltedSHA1PasswordHasher`和`UnsaltedMD5PasswordHasher`。
- **PostgreSQL字段**：移除了`CICharField`、`CIEmailField`、`CITextField`和`CIText` mixin。
- **其他**：移除了`map_width`和`map_height`属性、`SimpleTestCase.assertFormsetError()`方法、`TransactionTestCase.assertQuerysetEqual()`方法等。

#### 5. **注意事项**
- **升级指南**：升级项目时需检查所有不兼容更改和弃用功能。
- **文档更新**：更新后的文档包含Django 5.1及后续版本的发布说明。

总结：Django 5.1版本主要聚焦于移除旧功能、优化性能和提升可访问性，同时引入了新的实用功能，如`{% querystring %}`模板标签。开发者在升级时需特别注意不兼容更改，确保项目兼容性。