# Django 5.2.8 documentation

# Django 1.11 版本发行说明

2017 年 4 月 4 日

欢迎来到 Django 1.11 版本！

这些发布说明涵盖了 新功能，以及一些 不兼容变更，当您从 Django 1.10 或更早版本升级时，您需要注意。我们已经 开始了一些功能的弃用过程。

如果你要更新现有的项目，请看 如何将 Django 更新至新的版本 指南。

Django 1.11 被指定为 长期支持版本。它将在发布后至少三年内接收安全更新。对于之前的 LTS 版本 Django 1.8，支持将于 2018 年 4 月结束。

## Python 兼容性

Django 1.11 需要 Python 2.7、3.4、3.5、3.6 或 3.7（截止到 1.11.17 版本）。我们* 强烈建议* 并且只正式支持每个系列的最新版本。

Django 1.11.x 系列是支持 Python 2 的最后一个版本。下一个主要版本，Django 2.0，将仅支持 Python 3.4+。

## 弃用警告默认不再大声发出

与旧版本的 Django 不同，Django 自身的弃用警告默认不再显示。这与 Python 的默认行为一致。

此更改允许第三方应用在不添加用于避免弃用警告的代码的情况下同时支持 Django 1.11 LTS 和 Django 1.8 LTS 。

在发布 Django 2.0 后，我们建议第三方应用的作者停止支持所有在 1.11 之前的 Django 版本。在那时，您应该能够使用 `python -Wd` 运行您包的测试，以确保弃用警告出现。在修复弃用警告后，您的应用应该与 Django 2.0 兼容。

## Django 1.11 新特性

### 基于类的模型索引

新的 `django.db.models.indexes` 模块包含了用于简化创建数据库索引的类。索引可以通过在模型中使用 `Meta.indexes` 选项来添加。

`Index` 类创建一个 b-tree 索引，就像你在模型字段上使用 `db_index` 或在模型 `Meta` 类上使用 `index_together` 一样。它可以被子类化以支持不同的索引类型，例如 `GinIndex`。它还允许定义索引列的顺序（ASC/DESC）。

### 基于模板的小部件渲染

为了方便定制小部件，现在表单小部件的渲染是使用模板系统而不是在 Python 中进行的。请参阅 表单渲染 API。

你可能需要调整你编写的任何自定义小部件，以适应一些 不兼容变更。

### `Subquery` 表达式

新的 `Subquery` 和 `Exists` 数据库表达式允许创建明确的子查询。子查询可以使用 `OuterRef` 类引用来自外部查询集的字段。

### 次要特性

#### `django.contrib.admin`

- `ModelAdmin.date_hierarchy` 现在可以引用跨关联的字段。

- 新的 `ModelAdmin.get_exclude()` 钩子允许根据请求或模型实例指定要排除的字段。

- `popup_response.html` 模板现在可以按照每个应用程序、每个模型或通过设置 `ModelAdmin.popup_response_template` 属性来进行覆盖。

#### `django.contrib.auth`

- PBKDF2 密码哈希器的默认迭代次数增加了 20 %。

- `LoginView` 和 `LogoutView` 基于类的视图替代了已弃用的 `login()` 和 `logout()` 基于函数的视图。

- `PasswordChangeView`、`PasswordChangeDoneView`、`PasswordResetView`、`PasswordResetDoneView`、`PasswordResetConfirmView` 和 `PasswordResetCompleteView` 基于类的视图替代了已弃用的 `password_change()`, `password_change_done()`, `password_reset()`, `password_reset_done()`, `password_reset_confirm()`, 和 `password_reset_complete()` 基于函数的视图。

- `PasswordResetConfirmView` 的新属性 `post_reset_login` 允许在成功重置密码后自动登录用户。如果配置了多个 `AUTHENTICATION_BACKENDS`，可以使用 `post_reset_login_backend` 属性选择要使用的后端。

- 为了避免通过 HTTP Referer 标头泄露密码重置令牌的可能性（例如，如果重置页面包含对托管在另一个域上的 CSS 或 JavaScript 的引用），`PasswordResetConfirmView` （但不是已弃用的 `password_reset_confirm()` 基于函数的视图）将令牌存储在会话中，并重定向到自身，以向用户呈现不带令牌的 URL 的密码更改表单。

- `update_session_auth_hash()` 现在会旋转会话密钥，以允许密码更改来使被窃取的会话 Cookie 失效。

- `LoginView` 和 `LogoutView` 的新属性 `success_url_allowed_hosts` 允许指定一组安全的主机，用于在登录和注销后进行重定向。

- 已添加密码验证器的 `help_text` 到 `UserCreationForm`。

- `HttpRequest` 现在传递给 `authenticate()`，如果身份验证后端接受 `request` 参数，则它将传递给身份验证后端。

- `user_login_failed()` 信号现在接收一个 `request` 参数。

- `PasswordResetForm` 支持自定义用户模型，该模型使用名称不是 `'email'` 的电子邮件字段。将 `CustomUser.EMAIL_FIELD` 设置为字段的名称。

- `get_user_model()` 现在可以在导入时调用，即使在定义模型的模块中也可以。

#### `django.contrib.contenttypes`

- 在 `remove_stale_contenttypes` 命令中，当检测到陈旧的内容类型时，现在会列出一系列相关对象，如 `auth.Permission`，这些对象也将被删除。之前，只列出了内容类型（而且此提示是在 `migrate` 之后，而不是在一个单独的命令中）。

#### `django.contrib.gis`

- 新的 `GEOSGeometry.from_gml()` 和 `OGRGeometry.from_gml()` 方法允许从 GML 创建几何图形。

- 在 SpatiaLite 上新增了对 `dwithin` 查询的支持。

- `Area` 函数、`Distance` 函数以及距离查询现在在 SpatiaLite 上支持大地坐标。

- 基于 OpenLayers 的表单小部件现在使用来自 `https://cdnjs.cloudflare.com` 的 `OpenLayers.js`，这比旧的 `https://openlayers.org/` 源更适合生产使用。它们还更新为使用 OpenLayers 3。

- PostGIS 迁移现在可以改变字段尺寸。

- 现在可以在创建 `GDALRaster` 对象时传递 `size`、`shape` 和 `offset` 参数。

- 新增了对 `IsValid` 函数、`MakeValid` 函数以及 `isvalid` 查询的 SpatiaLite 支持。

- 新增了对 Oracle 数据库的支持，包括 `AsGML` 函数、`BoundingCircle` 函数、`IsValid` 函数以及 `isvalid` 查询。

#### `django.contrib.postgres`

- `StringAgg` 的新参数 `distinct` 决定了连接的值是否要去重。

- 新的 `GinIndex` 和 `BrinIndex` 类允许在数据库中创建 `GIN` 和 `BRIN` 索引。

- `django.contrib.postgres.fields.JSONField` 接受一个新的参数 `encoder`，用于指定自定义类以编码不受标准编码器支持的数据类型。

- 新的 `CIText` 混合类和 `CITextExtension` 迁移操作允许在 PostgreSQL 中使用 `citext` 扩展来进行不区分大小写的查找。提供了三个字段：`CICharField`、`CIEmailField` 和 `CITextField`。

- 新的 `JSONBAgg` 允许将值聚合为 JSON 数组。

- `HStoreField` （模型字段）和 `HStoreField` （表单字段）允许存储空值。

#### 缓存

- Memcached 后端现在将 `OPTIONS` 的内容作为关键字参数传递给客户端构造函数，允许更高级的客户端行为控制。请参阅 cache arguments 文档以获取示例。

- Memcached 后端现在允许在 `LOCATION` 中定义多个服务器，使用逗号分隔的字符串，以方便处理使用这种字符串的环境变量的第三方服务。

#### CSRF

- 新增了 `CSRF_USE_SESSIONS` 设置，允许将 CSRF 令牌存储在用户的会话中，而不是在 cookie 中。

#### 数据库后端

- Added the `skip_locked` argument to `QuerySet.select_for_update()` on PostgreSQL 9.5+ and Oracle to execute queries with `FOR UPDATE SKIP LOCKED`.

- 新增了 `TEST['TEMPLATE']` 设置，允许 PostgreSQL 用户指定用于创建测试数据库的模板。

- `QuerySet.iterator()` now uses server-side cursors on PostgreSQL. This feature transfers some of the worker memory load (used to hold query results) to the database and might increase database memory usage.

- 新增了对在 `OPTIONS` 中使用 `'isolation_level'` 选项的 MySQL 支持，允许指定 事务隔离级别。为了避免可能的数据丢失，建议从 MySQL 的默认级别 repeatable read 切换到 read committed。

- 新增了对 `cx_Oracle` 5.3 的支持。

#### 电子邮件

- 新增了 `EMAIL_USE_LOCALTIME` 设置，允许将 SMTP 日期标头发送到本地时区，而不是 UTC。

- `EmailMessage.attach()` 和 `attach_file()` 现在在为 text/* 附件指定无法解码为 UTF-8 的二进制内容时，会回退到 MIME 类型 application/octet-stream。

#### 文件存储

- 为了能够被 `io.TextIOWrapper` 包装，`File` 现在具有 `readable()`、`writable()` 和 `seekable()` 方法。

#### 表单

- 在 `CharField`、`EmailField`、`RegexField`、`SlugField` 和 `URLField` 上新增了 `empty_value` 属性，允许指定表示 "空" 的 Python 值。

- 新的 `Form.get_initial_for_field()` 方法返回表单字段的初始数据。

#### 国际化

- 数字格式化和 `NUMBER_GROUPING` 设置支持非均匀的数字分组。

#### 管理命令

- 新的 `loaddata --exclude` 选项允许在从 fixture 加载数据时排除模型和应用程序。

- 新的 `diffsettings --default` 选项允许指定与 Django 默认设置进行比较的设置模块。

- `app_label` 参数现在限制了 `showmigrations --plan` 输出。

#### 迁移

- 新增了对 `uuid.UUID` 对象的序列化支持。

#### 模型

- 在 `QuerySet.update_or_create()` 和 `get_or_create()` 的 `defaults` 参数中新增了对可调用值的支持。

- `ImageField` now has a default `validate_image_file_extension` validator. (This validator moved to the form field in Django 1.11.2.)

- `Trunc` 函数现在支持时间截断。

- 新增了 `ExtractWeek` 函数，用于从 `DateField` 和 `DateTimeField` 中提取周，并通过 `week` 查询公开。

- 新增了 `TruncTime` 函数，用于将 `DateTimeField` 截断到其时间组件，并通过 `time` 查询公开。

- 在 `QuerySet.values()` 和 `values_list()` 中添加了对表达式的支持。

- 对于接受多个参数的查询，如 `range`，新增了对查询表达式的支持。

- 现在可以在 `FileField` 上使用 `unique=True` 选项。

- 新增了 `Expression.asc()` 和 `desc()` 的 `nulls_first` 和 `nulls_last` 参数，用于控制空值的排序顺序。

- 新的 `F` 表达式中的 `bitleftshift()` 和 `bitrightshift()` 方法允许进行 位移位操作。

- 新增了 `QuerySet.union()`、`intersection()` 和 `difference()` 方法。

#### 请求和响应

- 新增了 `QueryDict.fromkeys()` 方法。

- `CommonMiddleware` 现在为非流式响应设置 `Content-Length` 响应头。

- 新增了 `SECURE_HSTS_PRELOAD` 设置，允许将 `preload` 指令附加到 `Strict-Transport-Security` 头部。

- `ConditionalGetMiddleware` 现在将 `ETag` 头部添加到响应中。

#### 序列化

- 新的 `django.core.serializers.base.Serializer.stream_class` 属性允许子类自定义默认流。

- 可以通过向 `serializers.serialize()` 函数传递一个 `cls` 关键字参数来自定义 JSON 序列化器 使用的编码器。

- `DjangoJSONEncoder` 现在可以序列化 `timedelta` 对象（被 `DurationField` 使用）。

#### 模板

- 现在可以将 `mark_safe()` 用作装饰器。

- `Jinja2` 模板后端现在支持通过在 `OPTIONS` 中设置 `'context_processors'` 选项来配置上下文处理器。

- `regroup` 标签现在返回 `namedtuple` 而不是字典，因此你可以在循环中直接解包组对象，例如 `{% for grouper, list in regrouped %}`。

- 新增了 `resetcycle` 模板标签，允许重置 `cycle` 模板标签的序列。

- 现在可以为特定的 `filesystem.Loader` 指定特定的目录。

#### 测试

- 新增了 `DiscoverRunner.get_test_runner_kwargs()` 方法，允许自定义传递给测试运行器的关键字参数。

- 新增了 `test --debug-mode` 选项，通过将 `DEBUG` 设置为 `True` 来帮助排查测试失败。

- 新的 `django.test.utils.setup_databases()` （从 `django.test.runner` 移动过来）和 `teardown_databases()` 函数使构建自定义测试运行器更加容易。

- 在使用 `test --parallel` 选项时，新增了对 `unittest.TestCase.subTest()` 的支持。

- `DiscoverRunner` 现在在测试运行开始时运行系统检查。如果要禁用此功能，请覆盖 `DiscoverRunner.run_checks()` 方法。

#### 验证器

- 新增了 `FileExtensionValidator` 以验证文件扩展名，以及 `validate_image_file_extension` 以验证图像文件。

## 1.11 中的向后不兼容更改

### `django.contrib.gis`

- 为了简化代码库并且因为现在安装起来更容易（相对于最初发布 `contrib.gis` 时的情况），现在在 GeoDjango 中需要 GDAL 作为依赖。在旧版本中，它只对 SQLite 有要求。

- `contrib.gis.maps` 已被移除，因为它与已退役的 Google Maps API 版本进行交互，似乎没有维护。如果您正在使用它，请 告诉我们。

- `GEOSGeometry` 的等号运算符现在也会比较 SRID。

- 基于 OpenLayers 的表单小部件现在使用 OpenLayers 3，同时更新了 `gis/openlayers.html` 和 `gis/openlayers-osm.html` 模板。如果您对这些小部件进行子类化或扩展模板，请检查您的项目。此外，新的小部件与旧的小部件有一些不同。不再使用小部件中的工具栏，而是点击以绘制，点击并拖动以移动地图，以及点击并拖动一个点/顶点/角来移动它。

- 不再支持 SpatiaLite < 4.0 。

- 不再支持 GDAL 1.7 和 1.8 。

- `contrib.gis.forms.widgets` 中的小部件和管理员的 `OpenLayersWidget` 现在使用 表单渲染 API 而不是 `loader.render_to_string()`。如果您使用自定义小部件模板，您需要确保您的表单渲染器可以找到它。例如，您可以使用 `TemplatesSetting` 渲染器。

### `django.contrib.staticfiles`

- 当使用散列的静态文件存储时，如果存在引用循环（例如，`'foo.css'` 引用 `'bar.css'`，而 `'bar.css'` 又引用 `'foo.css'`），或者如果引用其他文件的文件链过深，无法在多次传递中解析，那么 `collectstatic` 在后处理期间可能会失败。在后一种情况下，可以通过 `ManifestStaticFilesStorage.max_post_process_passes` 增加传递次数。

- 当使用 `ManifestStaticFilesStorage` 时，运行时未在清单中找到的静态文件现在会引发 `ValueError`，而不是返回不变的路径。您可以通过将 `ManifestStaticFilesStorage.manifest_strict` 设置为 `False` 来恢复到旧的行为。

### 数据库后端 API

本节介绍了第三方数据库后端可能需要的更改。

- 新增了 `DatabaseOperations.time_trunc_sql()` 方法，以支持 `TimeField` 截断。它接受一个 `lookup_type` 和 `field_name` 参数，并返回将给定时间字段 `field_name` 截断为只具有给定精度的时间对象的适当 SQL。`lookup_type` 参数可以是 `'hour'`、`'minute'` 或 `'second'`。

- 新增了 `DatabaseOperations.datetime_cast_time_sql()` 方法，以支持 `time` 查询。它接受一个 `field_name` 和 `tzname` 参数，并返回将日期时间值强制转换为时间值所需的 SQL。

- 要启用 `FOR UPDATE SKIP LOCKED` 支持，请设置 `DatabaseFeatures.has_select_for_update_skip_locked = True`。

- 新的 `DatabaseFeatures.supports_index_column_ordering` 属性指定数据库是否允许在索引中定义列的排序。默认值为 `True`，而 `DatabaseIntrospection.get_constraints()` 方法应在每个返回的字典中包含一个 `'orders'` 键，该键包含一个列表，其中包含与索引中每列的排序对应的 `'ASC'` 和/或 `'DESC'` 值。

- `inspectdb` 不再调用已弃用的 `DatabaseIntrospection.get_indexes()` 方法。自定义数据库后端应确保 `DatabaseIntrospection.get_constraints()` 返回所有类型的索引。

- 将 `ignores_quoted_identifier_case` 功能的名称更改为 `ignores_table_name_case`，以更准确地反映它的使用方式。

- 新增了 `name` 关键字参数到 `DatabaseWrapper.create_cursor(self, name=None)` 方法，以允许在支持的后端上使用服务器端游标。

### 不再支持 PostgreSQL 9.2 和 PostGIS 2.0 。

PostgreSQL 9.2 的上游支持将于 2017 年 9 月结束。因此，Django 1.11 将 PostgreSQL 9.3 设为其官方支持的最低版本。

由于 PostgreSQL 9.2 是支持 PostGIS 2.0 的最后一个版本，因此也取消了对 PostGIS 2.0 的支持。

此外，支持的最低 psycopg2 版本从 2.4.5 提高到 2.5.4 。

### `LiveServerTestCase` 现在绑定到零端口

与其采用端口范围并迭代查找空闲端口，`LiveServerTestCase` 现在绑定到零端口，并依赖操作系统分配空闲端口。不再使用 `DJANGO_LIVE_TEST_SERVER_ADDRESS` 环境变量，也不再使用 `manage.py test --liveserver` 选项。

如果需要将 `LiveServerTestCase` 绑定到特定端口，可以使用 Django 1.11.2 中新增的 `port` 属性。

### 在 `django.contrib.auth` 和 `i18n` 视图中加强了对不安全的重定向的保护。

`LoginView`、`LogoutView` （以及已弃用的函数式等效版本）和 `set_language()` 在应用程序运行在 HTTPS 上时，会保护用户免受被重定向到非 HTTPS 的 `next` URL 的影响。

### `QuerySet.get_or_create()` 和 `update_or_create()` 现在会验证参数。

为了防止拼写错误默默通过，`get_or_create()` 和 `update_or_create()` 检查它们的参数是否是模型字段。这只会在一个方面引入向后不兼容，可能会暴露出项目中的错误。

### `pytz` 现在是必需的依赖项，不再支持将 `settings.TIME_ZONE = None`。

为了简化 Django 的时区处理，`pytz` 现在是必需的依赖项，它会自动与 Django 一起安装。

不再支持 `settings.TIME_ZONE = None`，因为这种行为通常不常用且可疑的有用性。如果希望根据系统时区自动检测时区，可以使用 tzlocal。

    from tzlocal import get_localzone

    TIME_ZONE = get_localzone().zone

这与 `settings.TIME_ZONE = None` 类似，但它还设置了 `os.environ['TZ']`。如果存在情况下，您发现无法适应设置 `TIME_ZONE` 的代码，请通过 告诉我们。

### 管理模板中的 HTML 更改

`<p class="help">` 被替换为 `<div>` 标签，以允许在帮助文本中包含列表。

只读字段现在被包装在 `<div class="readonly">...</div>` 中，而不是 `<p>...</p>`，以允许字段内容包含任何类型的 HTML。

### 由于引入基于模板的小部件渲染，发生了一些更改。

移除了 `django.forms.widgets` 中一些未记录的类：

- `SubWidget`

- `RendererMixin`, `ChoiceFieldRenderer`, `RadioFieldRenderer`, `CheckboxFieldRenderer`

- `ChoiceInput`, `RadioChoiceInput`, `CheckboxChoiceInput`

移除了未记录的 `Select.render_option()` 方法。

移除了 `Widget.format_output()` 方法。请使用自定义小部件模板替代。

如果 `settings.USE_L10N=True`，现在某些小部件的值，如 `<select>` 选项，将进行本地化。您可以通过使用 `localize` 模板标签关闭本地化，恢复到旧的行为，使用自定义小部件模板。

### `django.template.backends.django.Template.render()` 禁止非字典上下文。

为了与多个模板引擎兼容，`django.template.backends.django.Template.render()` （从高级模板加载器 API（如 `loader.get_template()`）返回）必须接收一个上下文字典，而不是 `Context` 或 `RequestContext`。如果您之前传递了这两个类中的任何一个，请改为传递一个字典 - 这样做是向后兼容旧版本的 Django。

### 迁移操作中的模型状态更改

为了提高应用迁移的速度，延迟了相关模型的渲染，直到需要它们的操作（例如 `RunPython`）。如果您有一个自定义操作，需要在 `database_forwards()` 或 `database_backwards()` 的 `from_state` 参数中使用模型类或模型实例，您必须使用 `clear_delayed_apps_cache()` 方法来渲染模型状态，如 编写自己的迁移操作 中所述。

### PostgreSQL 上的服务器端游标

The change to make `QuerySet.iterator()` use server-side cursors on PostgreSQL prevents running Django with PgBouncer in transaction pooling mode. To reallow that, use the `DISABLE_SERVER_SIDE_CURSORS` setting (added in Django 1.11.1) in `DATABASES`.

有关更多讨论，请参阅 事务池和服务器端游标。

### 杂项

- 如果在 feed 中没有任何项目具有 `pubdate` 或 `updateddate` 属性，那么 `SyndicationFeed.latest_post_date()` 现在会返回当前的 UTC 日期/时间，而不是一个没有任何时区信息的 datetime。

- CSRF 失败现在会被记录到 `django.security.csrf` 日志器，而不是 `django.request`。

- 运行测试时，不再禁用 `ALLOWED_HOSTS` 验证。如果您的应用程序包括具有自定义主机名的测试，您必须将这些主机名包含在 `ALLOWED_HOSTS` 中。请参阅 测试与多主机名。

- 在 `ModelAdmin.list_display` 中使用外键的 id（例如 `'field_id'`）会显示相关对象的 ID。如果要恢复到对象的字符串表示的旧行为，请移除 `_id` 后缀。

- 在模型表单中，具有 `null=True` 的 `CharField` 现在会为空白值保存 `NULL`，而不是空字符串。

- 在 Oracle 上，`Model.validate_unique()` 不再检查空字符串的唯一性，因为数据库会将该值解释为 `NULL`。

- 如果您子类化了 `AbstractUser` 并覆盖了 `clean()` 方法，请确保它调用了 `super()`。新的 `AbstractUser.clean()` 方法中会调用 `BaseUserManager.normalize_email()`，以便在模型表单验证等情况下应用标准化。

- `EmailField` 和 `URLField` 不再接受 `strip` 关键字参数。移除它，因为在旧版本的 Django 中它没有任何效果，这些字段总是会去除空格。

- 表单小部件渲染的 `checked` 和 `selected` 属性现在使用 HTML5 布尔语法，而不再使用 XHTML 的 `checked='checked'` 和 `selected='selected'`。

- `RelatedManager.add()`、`remove()`、`clear()` 和 `set()` 现在会清除 `prefetch_related()` 缓存。

- 为防止可能丢失的保存设置，如果在调用 `teardown_test_environment()` 之前再次调用 `setup_test_environment()`，它现在会引发异常。

- 未记录的 `DateTimeAwareJSONEncoder` 别名（对于在 Django 1.0 中更名的 `DjangoJSONEncoder`）已被移除。

- 如果没有指定 `OPTIONS['loaders']` 并且 `OPTIONS['debug']` 为 `False` （后者默认为 `DEBUG` 的值），则现在会启用 `cached template loader`。如果您有一些不是线程安全的 模板标签，这可能会导致不兼容。

- 过去在运行 `migrate` 命令之后不再提示删除陈旧的内容类型。现在请使用新的 `remove_stale_contenttypes` 命令。

- 管理员界面中的 `IntegerField` 控件现在使用 `type="number"` 而不是 `type="text"`。

- 现在，条件 HTTP 标头根据 RFC 7232 的条件请求规范进行解析和比较，而不是较旧的 RFC 2616 规范。

- `patch_response_headers()` 不再添加 `Last-Modified` 标头。根据 RFC 7234 Section 4.2.2，在提供明确的过期时间的其他缓存标头旁边，例如 `Expires` 或 `Cache-Control`，此标头是无用的。因此，`UpdateCacheMiddleware` 和 `add_never_cache_headers()` 调用 `patch_response_headers()`，因此也受到此更改的影响。

- 在管理模板中，`<p class="help">` 被替换为 `<div>` 标签，以允许在帮助文本中包含列表。

- `ConditionalGetMiddleware` 不再设置 `Date` 头，因为 web 服务器会设置该头。它也不再设置 `Content-Length` 头，因为现在由 `CommonMiddleware` 完成此操作。

  如果您有一个中间件在 `MIDDLEWARE` 或 `MIDDLEWARE_CLASSES` 设置中出现在 `CommonMiddleware` 之前，并且修改响应的内容，那么您必须重新排列您的中间件，以确保在设置 `Content-Length` 后不会修改响应，或者让修改响应的中间件重置 `Content-Length` 头。

- `get_model()` 和 `get_models()` 现在在所有应用程序的模型加载之前调用时会引发 `AppRegistryNotReady` 异常。以前它们只需要目标应用程序的模型被加载，因此可能返回未完全设置其关系的模型。如果您需要 `get_model()` 的旧行为，请将 `require_ready` 参数设置为 `False`。

- 未使用的 `BaseCommand.can_import_settings` 属性已被删除。

- 未记录的 `django.utils.functional.lazy_property` 已被移除。

- 为了与非多部分请求保持一致，`MultiPartParser.parse()` 现在会使 `request.POST` 保持不可变性。如果你要修改那个 `QueryDict`，你现在必须先复制它，例如 `request.POST.copy()`。

- 对于 `cx_Oracle` 版本小于 5.2 的支持已被移除。

- 对于 IPython 版本小于 1.0 的支持已从 `shell` 命令中移除。

- 私有 API `Widget.build_attrs()` 的签名已从 `extra_attrs=None, **kwargs` 更改为 `base_attrs, extra_attrs=None`。

- 通过测试客户端上传到一个 `ImageField` 的类似文件的对象（例如 `StringIO` 和 `BytesIO`）现在需要一个具有通过 `validate_image_file_extension` 验证器的值的 `name` 属性。请参阅 `Client.post()` 中的注意事项。

- `FileField` 现在会移动文件而不是复制它所接收的文件。使用默认的文件上传设置，文件大小超过 `FILE_UPLOAD_MAX_MEMORY_SIZE` 的文件现在具有与临时文件相同的权限（通常是 `0o600`），而不是系统的标准掩码（通常是 `0o644`）。如果您需要不考虑文件大小都具有相同权限，请设置 `FILE_UPLOAD_PERMISSIONS`。

## 在 1.11 中被废弃的功能

### `models.permalink()` 装饰器

请使用 `django.urls.reverse()`。例如：

    from django.db import models

    class MyModel(models.Model):
        ...

        @models.permalink
        def url(self):
            return ("guitarist_detail", [self.slug])

变成：

    from django.db import models
    from django.urls import reverse

    class MyModel(models.Model):
        ...

        def url(self):
            return reverse("guitarist_detail", args=[self.slug])

### 杂项

- `contrib.auth` 中的 `login()` 和 `logout()` 基于函数的视图已被弃用，推荐使用新的基于类的视图 `LoginView` 和 `LogoutView`。

- `contrib.auth.views.logout_then_login()` 的未使用的 `extra_context` 参数已被弃用。

- `contrib.auth` 中的 `password_change()`, `password_change_done()`, `password_reset()`, `password_reset_done()`, `password_reset_confirm()`, 和 `password_reset_complete()` 基于函数的视图已被弃用，推荐使用新的基于类的视图 `PasswordChangeView`, `PasswordChangeDoneView`, `PasswordResetView`, `PasswordResetDoneView`, `PasswordResetConfirmView`, 和 `PasswordResetCompleteView`。

- `django.test.runner.setup_databases()` 已移至 `django.test.utils.setup_databases()`。旧位置已被弃用。

- `django.utils.translation.string_concat()` 已被弃用，推荐使用 `django.utils.text.format_lazy()`。可以通过 `format_lazy('{}' * len(strings), *strings)` 来替代 `string_concat(*strings)`。

- 对于 `PyLibMCCache` 缓存后端，将 `pylibmc` 行为设置作为 `OPTIONS` 的顶级属性传递已被弃用。请将它们设置在 `OPTIONS` 内的 `behaviors` 键下。

- `django.utils.http.is_safe_url()` 的 `host` 参数已被弃用，推荐使用新的 `allowed_hosts` 参数。

- 在渲染 `{% include %}` 模板标签时抑制异常已被弃用，因为这种行为通常会比有帮助更令人困惑。在 Django 2.1 中，将会引发异常。

- `DatabaseIntrospection.get_indexes()` 已被弃用，推荐使用 `DatabaseIntrospection.get_constraints()`。

- `authenticate()` 现在向身份验证后端的 `authenticate()` 方法传递一个 `request` 参数。不接受 `request` 作为第一个位置参数的方法将在 Django 2.1 中被移除。

- `USE_ETAGS` 设置已被弃用，推荐使用 `ConditionalGetMiddleware`，它现在会在响应中添加 `ETag` 头，不受设置的影响。当弃用结束时，`CommonMiddleware` 和 `django.utils.cache.patch_response_headers()` 将不再设置 ETags。

- `Model._meta.has_auto_field` 已被弃用，推荐检查 `Model._meta.auto_field is not None`。

- 在 `url()` 中使用带有 `iLmsu#` 的正则表达式组已被弃用。唯一有用的组是 `(?i)` 用于不区分大小写的 URL，但是不区分大小写的 URL 并不是一个好的实践，因为它们会为搜索引擎创建多个条目，例如。一个替代方案可能是创建一个 `handler404`，它查找 URL 中的大写字符并重定向到相应的小写字符。

- `renderer` 参数已添加到 `Widget.render()` 方法。不接受该参数的方法将在一个弃用期内继续工作。