Django3.0中向后不兼容的更改

3.0中向后不兼容的更改

数据库后端API

本节描述了第三方数据库后端中可能需要的更改。

• 现在的第二个参数DatabaseIntrospection.get_geometry_type()是行描述，而不是列名。
• DatabaseIntrospection.get_field_type() 可能不再返回元组。
• 如果数据库可以在添加字段的同一SQL语句中创建外键，请添加SchemaEditor.sql_create_column_inline_fk适当的SQL；否则，请添加相应的SQL。否则，设置。DatabaseFeatures.can_create_inline_fk = False
• DatabaseFeatures.can_return_id_from_insert并且 can_return_ids_from_bulk_insert被重命名为 can_return_columns_from_insert和can_return_rows_from_bulk_insert。
• 现在，数据库函数可以处理datetime.timezone使用datetime.timedelta实例创建的格式（例如 timezone(timedelta(hours=5))输出'UTC+05:00'）。DateTimeField在，等中进行准备时datetime_cast_date_sql()， 第三方后端应处理此格式 datetime_extract_sql()。
• 条目AutoField，BigAutoField和SmallAutoField被添加到 DatabaseOperations.integer_field_ranges支持关于这些字段类型的整数范围的验证。第三方后端可能需要自定义默认条目。
• DatabaseOperations.fetch_returned_insert_id()替换为， fetch_returned_insert_columns()它返回语句返回的值列表，而不是单个值。INSERT … RETURNING
• DatabaseOperations.return_insert_id()替换为 return_insert_columns()接受fields 参数的参数，该参数是插入后要返回的字段的可迭代项。通常，这只是自动生成的主键。

django.contrib.admin

• 管理员的模型历史记录更改消息现在倾向于使用更具可读性的字段标签，而不是字段名称。

django.contrib.gis

• 不再支持PostGIS 2.1。
• 删除了对SpatiaLite 4.1和4.2的支持。
• 删除了对GDAL 1.11和GEOS 3.4的支持。

不再支持PostgreSQL 9.4

对PostgreSQL 9.4的上游支持将于2019年12月结束。Django3.0支持PostgreSQL 9.5和更高版本。

不再支持Oracle 12.1

对Oracle 12.1的上游支持将于2021年7月结束。Django2.2将一直支持到2022年4月。Django3.0正式支持Oracle 12.2和18c。

删除了专用的Python 2兼容性API

尽管在Django 2.0中删除了对Python 2的支持，但并未从Django中删除某些私有API，因此第三方应用程序可以继续使用它们，直到Python 2终止使用为止。

由于我们希望应用在添加对Django 3.0的支持时会降低Python 2的兼容性，因此我们目前正在删除这些API。

• django.test.utils.str_prefix() -Python 3中的字符串没有'u'前缀。
• django.test.utils.patch_logger()- unittest.TestCase.assertLogs()改用。
• django.utils.lru_cache.lru_cache()-的别名 functools.lru_cache()。
• django.utils.decorators.available_attrs()-此函数返回 functools.WRAPPER_ASSIGNMENTS。
• django.utils.decorators.ContextDecorator-的别名 contextlib.ContextDecorator。
• django.utils._os.abspathu()-的别名os.path.abspath()。
• django.utils._os.upath()和npath()-这些功能在Python 3上不起作用。
• django.utils.six-删除此供应商库的使用或切换到 六个。
• django.utils.encoding.python_2_unicode_compatible()-的别名 six.python_2_unicode_compatible()。
• django.utils.functional.curry()-使用functools.partial()或 functools.partialmethod。参见5b1c389603a353625ae1603。
• django.utils.safestring.SafeBytes -自Django 2.0起未使用。

对于新的默认值FILE_UPLOAD_PERMISSIONS设置

在旧版本中，该FILE_UPLOAD_PERMISSIONS设置默认为 None。使用默认值FILE_UPLOAD_HANDLERS，这会导致上载的文件具有不同的权限，具体取决于它们的大小和使用的上载处理程序。

FILE_UPLOAD_PERMISSION现在默认为0o644避免这种不一致。

安全设置新的默认值

为了使Django项目默认更安全，某些安全设置现在具有更安全的默认值：

• X_FRAME_OPTIONS现在默认为'DENY'。
• SECURE_CONTENT_TYPE_NOSNIFF现在默认为True。

有关这些更改的更多详细信息，请参见上面的“新增 安全性”部分。

杂项

• ContentType.__str__()现在包含了该模型app_label，可在不同应用中消除同名模型的歧义。
• 因为不赞成在会话中而不是在cookie中访问语言，所以注销后不再在会话中LocaleMiddleware查找用户的语言，django.contrib.auth.logout()也不再保留会话的语言。
• django.utils.html.escape()现在用于html.escape()转义HTML。这将转换'为'而不是先前的等效十进制代码'。
• 该选项现在工作作为选项，而不是作为一个快捷方式。django-admin test -kunittest -k--keepdb
• pywatchman<1.2.0的支持已删除。
• urlencode()现在可以对whener进行编码doseq=False，而不是对其进行迭代，从而使其与标准库urllib.parse.urlencode()函数保持一致。
• intword模板过滤器现在转换1.0为单数短语，所有其他数值转换为复数形式。对于某些语言，这可能是不正确的。
• 现在，将值分配给模型的ForeignKey或 属性会取消设置相应的字段。之后访问该字段将导致查询。OneToOneField '_id'
• patch_vary_headers()现在 '*'根据RFC 7231＃section-7.1.4，即，如果标头字段名称列表包含星号，则Vary标头将由单个星号组成'*'。
• 在MySQL 8.0.16+，PositiveIntegerField而PositiveSmallIntegerField 现在包括检查约束，以防止数据库中的负值。
• alias=None已添加到的签名 Expression.get_group_by_cols()。
• sqlparse<0.2.2的支持已删除。