Drupal10发行说明

原文地址:https://www.drupal.org/project/drupal/releases/10.0.0

翻译:长风Drupal开发

一、发行说明
这是新Drupal 10主要版本的第一个受支持的版本,它已经可以在生产站点上使用了!了解更多关于Drupal 10和Drupal核心发布周期的信息。

Drupal 10.0.0与Drupal 9.5.0同时发布。Drupal 9.5具有Drupal 10所做的大部分更改,但保留了通过Drupal 9.5.0版本添加的向后兼容层。在更新到Drupal 10之前更新到Drupal9.5,以获得最平滑的升级路径。

如果您正在启动一个新的Drupal项目,您可以在Drupal 9.5.0和10.0.0之间进行选择,并且通常应该在可能的情况下选择Drupal 10,以便与未来的版本向前兼容。

无论您现在选择哪个版本,功能都只会添加到Drupal 10小版本中。计划采用Drupal 10,以便您可以轻松更新到Drupal 10.1及更高版本。

请参阅准备站点升级到较新的主要版本,以获取可用于检查模块、主题和站点的Drupal 10兼容性的工具。然后,从Drupal9升级到Drupal10

Drupal 10.0.0和Drupal 9.5.0都包含所有最新的更改,除了少数边缘情况外,它们都具有相同的API和功能。这也意味着模块和主题可以同时与Drupal 9和10兼容!10.0.0中的关键更改包括:

1、弃用的代码,包括整个模块和主题,已被删除。

2、依赖项已酌情更新为新的主要版本。

3、平台需求(包括支持的PHP和数据库版本、Composer需求和支持的浏览器)已经更新。


二、重要更新信息
在升级到Drupal 10之前,站点必须至少更新到Drupal 9.4.4
运行9.3.x或更早版本的Drupal站点必须首先更新到9.4.4或更高版本,然后才能更新到Drupal 10。9.4.0之前添加的所有核心更新都已删除,从CKEditor 4到CKEditor 5的数据升级路径在Drupal 9.4.4之前不可用。一般来说,在更新到下一个主要版本之前,站点应该更新到当前主要分支的最新版本。

使用CKEditor 4的网站应在更新到Drupal 10之前升级到Drupal 9.4或9.5中的CKEditor 5
大多数使用CKEditor 4的Drupal网站应该升级到CKEditor 5。有关详细信息,请参阅CKEditor的建议。从CKEditor 4升级到5是一个手动过程,因为它需要人工监督。

对站点所有者管理的文件的更改
Apache为浏览器提供gzip JavaScript和CSS聚合,性能得到了改善。网站应该更新.htaccess文件以利用这种性能改进。

yarn.lock和package.json现在被Drupal的默认web服务器配置阻止,站点应该更新.htaccess或web.config的任何副本以合并这些更改。

不再需要或建议在settings.php中配置快速404s。

默认robots.txt文件已更新,不允许为oEmbed媒体链接编制索引。

添加了一个新的开发人员功能,用于显示渲染缓存的调试标记。它可以在services.yml中配置,默认情况下禁用。站点应确保其站点特定服务.yml包含新部分。

为了与10.1.x中的弃用保持前向兼容性,对example.settings.local.php中的断言处理默认值进行了更改。站点所有者可以更新其settings.local.php以保持一致性和前向兼容性。

三、Drupal10安装的环境要求

1、PHP要求
Drupal 10需要PHP 8.1或更高版本。
PHP 8.1.0到8.1.5版本的PHP OPcache存在一个错误,可能会在运行时导致类自动加载的间歇性致命错误,因此建议使用PHP 8.1.6或更高版本。
当网站使用的PHP版本已达到其正式使用期限时,Drupal状态报告页面上会显示警告。这不会阻止运行、更新或安装Drupal,除非版本低于绝对最低要求。查看有关不支持的PHP版本的手册文档以了解更多信息。

2、数据库要求
Drupal 10核心支持以下最低数据库版本:
MySQL或Percona 5.7.8。
MariaDB 10.3.7(这是一个比MySQL版本更新的版本。)
带有pg_trgm扩展名的PostgreSQL 12。
带有JSON1扩展名的SQLite 3.26。PHP并不总是使用系统提供的SQLite,因此请验证您的PHP是否至少使用此版本编译。

3、浏览器支持更改
Drupal 10不支持Internet Explorer 11。
已删除对旧版本UC浏览器的支持。依赖WebView的较新版本的浏览器应不受影响。
有关详细信息,请参阅浏览器支持策略。

4、Composer要求
Drupal 10推荐Composer 2.3.6或更高版本,这是与PHP 8.2和即将推出的自动更新功能兼容所必需的。核心开发人员必须至少更新到Composer 2.3.6才能在Drupal核心上工作,站点所有者将收到旧版本的警告。Drupal不会安装或更新低于2.1的Composer版本。

要更新主机的Composer版本,请运行:

Composer自我更新
您可以随时使用以下方法回滚到以前的版本:
composer self-update --rollback

使用以下选项更新到特定版本:
composer self-update 2.3.6

如果您对Drupal10安装的环境要求仍有疑问,可以联系成都长风Drupal开发团队。