3.0中不推荐使用的功能
django.utils.encoding.force_text()
和smart_text()``的
别名被弃用。如果您的代码支持Python 2,smart_str()
并且 force_str()
在此处有所不同,请忽略此弃用。
杂项
django.utils.http.urlquote()
,urlquote_plus()
,urlunquote()
,并urlunquote_plus()
在赞成不赞成使用的功能,他们正在别名:urllib.parse.quote()
,quote_plus()
,unquote()
,和unquote_plus()
。django.utils.translation.ugettext()
,ugettext_lazy()
,ugettext_noop()
,ungettext()
,并ungettext_lazy()
在赞成不赞成使用的功能,他们正在别名:django.utils.translation.gettext()
,gettext_lazy()
,gettext_noop()
,ngettext()
,和ngettext_lazy()
。- 为了限制会话的创建并因此支持某些缓存策略,
django.views.i18n.set_language()
将停止在Django 4.0中的会话中设置用户的语言。从Django 2.1开始,该语言始终存储在LANGUAGE_COOKIE_NAME
cookie中。 django.utils.text.unescape_entities()
不推荐使用html.unescape()
。请注意,与不同unescape_entities()
,它会html.unescape()
立即评估惰性字符串。- 为了避免在有效范围方面造成混淆,将专用内部实用程序
is_safe_url()
重命名为url_has_allowed_host_and_scheme()
。URL具有允许的主机和方案,通常并不表示其“安全”。例如,它可能仍然引用不正确。确保还在iri_to_uri()
不可信URL的路径组件上使用 。
3.0中删除的功能
这些功能已到弃用周期的尽头,并已在Django 3.0中删除。
有关这些更改的详细信息,请参阅2.0中不推荐使用的功能,包括如何删除对这些功能的使用。
- 该
django.db.backends.postgresql_psycopg2
模块已卸下。 django.shortcuts.render_to_response()
已移除。- 该
DEFAULT_CONTENT_TYPE
设置将被删除。 HttpRequest.xreadlines()
已移除。- 为支持
context
的论据Field.from_db_value()
和Expression.convert_value()
被删除。 - 所述
field_name
的关键字参数QuerySet.earliest()
和latest()
被去除。
有关这些更改的详细信息,请参阅2.1中不推荐使用的功能,包括如何删除对这些功能的使用。
- 该
ForceRHR
GIS功能被删除。 django.utils.http.cookie_date()
已移除。- 在
staticfiles
和admin_static
模板标签库被删除。 django.contrib.staticfiles.templatetags.staticfiles.static()
已移除。
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 -k
unittest -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的支持已删除。
============================================== 华丽的分割线 ==================================================
设置postgresql
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'xx',
'USER': 'xx',
'PASSWORD': 'xx',
'HOST': 'localhost',
'PORT': '5432',
}
}
从django1.9开始,已经修改为django.db.backends.postgresql,只是设置了别名做映射
pip需要安装的依赖包不再是postgresql_psycopg2,而是postgres,
pipenv同理都是安装postgres,安装后会自动依赖psycopg2以及psycopg2_pool
Reference:
https://www.cnblogs.com/worldinmyeyes/p/12018229.html