Django 5.1 Documentation

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

摘要

Django 5.1版本引入了多项新功能和改进，包括新增的{% querystring %}模板标签用于简化URL查询参数的修改，提升了模板层的灵活性。此外，数据库后端API进行了优化，支持更多高级查询和表达式。Django 5.1还增强了安全性，改进了用户认证系统和密码哈希算法。同时，文档更新了对第三方库的兼容性说明，并提供了详细的迁移指南以帮助用户从旧版本升级。版本还对多个功能模块进行了性能优化和功能扩展，如GIS功能、邮件发送和文件上传等。

AI总结

《Django 5.1 Documentation》总结如下：

### 核心功能模块

1. **文件上传**
- **概述**：文件处理的基础知识。
- **文件对象**：管理文件的接口和方法。
- **存储API**：自定义存储解决方案。
- **中断处理**：新增`FileUploadHandler.upload_interrupted()`回调处理中断上传。

2. **基于类的视图**
- **概述**：基于类的视图的使用方法。
- **内置视图**：展示和编辑视图的使用。
- ** mixins**：混入的使用技巧。
- **API参考**：详细API文档。

3. **模板层**
- **基础**：模板语法和基本用法。
- **设计者视角**：语言概览、内置标签和过滤器。
- **开发视角**：自定义标签和过滤器、模板后端。

4. **表单处理**
- **基础**：表单API、内置字段和小部件。
- **高级功能**：模型表单、表单集和自定义验证。

5. **开发流程**
- **设置**：配置 Django 应用的详细说明。
- **应用程序**：创建和管理应用程序。
- **异常处理**：常见错误处理方法。
- **命令行工具**：`django-admin`和`manage.py`的使用。
- **测试**：编写和运行测试用例。
- **部署**：WSGI和ASGI服务器配置、静态文件部署。

### 新功能与改进

1. **新功能**
- **模板标签**：引入`{% querystring %}`简化URL查询参数处理。
- **数据库功能**：新增`durable`参数保证事务提交、`JSONObject`函数。
- **查询优化**：`Paginator.get_elided_page_range()`生成精简分页链接。
- **响应头管理**：`HttpResponse.headers`支持直接设置响应头。
- **安全增强**：`Signer.sign_object()`和`Signer.unsign_object()`用于签名复杂数据结构，`SECRET_KEY`配置优化。

2. **性能与兼容性**
- **性能提升**：支持Python 3.10、3.11、3.12。
- **第三方库升级**：jQuery升级到3.7.1，GDAL升级支持3.7，GEOS升级到3.12。

3. **新方法与API**
- **认证**：新增异步认证函数`aauthenticate()`等，`AuthenticationMiddleware`提供异步用户获取方法。
- **内容类型**：`prefetch_related()`支持通用外键的非同质化结果。
- **GIS功能**：新增`ClosestPoint()`函数、`GEOSGeometry.equals_identical()`方法。
- **消息系统**：`MessagesTestMixin.assertMessages()`用于测试消息。

### 向后不兼容更改

1. **数据库**
- 移除对MySQL <8.0.11、GDAL 2.2/2.3、GEOS 3.6/3.7的支持。

2. **sitemaps**
- 移除`ping_google()`函数和管理命令，`SitemapNotFound`异常被移除。

3. **其他**
- 数据库后端API调整，部分测试需跳过或标记为预期失败。

### 其他改进

1. **邮件**
- 新增`EMAIL_USE_LOCALTIME`设置，处理SMTP日期头。

2. **文件存储**
- `File`对象新增`readable()`、`writable()`、`seekable()`方法，支持`io.TextIOWrapper`。

3. **管理命令**
- 新增`loaddata --exclude`排除模型加载，`diffsettings --default`比较设置。

4. **国际化**
- 支持非均匀数字分组设置`NUMBER_GROUPING`。

5. **测试**
- 新增`--durations`选项显示测试用时（Python 3.12+）。

### 总结

Django 5.1版本在模板、表单、数据库、安全、部署等方面进行了多项改进和优化，新增了多个实用功能，同时移除了部分旧功能以保持轻量化和高效性。建议用户及时更新项目，确保兼容性和安全性。