Django 5.1 Documentation

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