PHP8.5与Drupal10兼容性测试报告

Drupal 10.3（当前最新稳定版）完全不支持PHP 8.5——不仅官方未做任何兼容性测试或声明，其composer.json硬性限制PHP 8.1–8.3，核心代码、模块生态及底层扩展均未适配PHP 8.4+引入的严格类型规则、命名参数移除、mysqli字段映射变更等关键变化；强行运行将从Composer安装阶段就失败，或在请求加载、数据库查询、模板渲染等环节触发致命错误；临时绕过方案代价高昂且不可用于生产环境；正确做法是暂缓升级，坚守PHP 8.3.13，或通过Docker/PHPBrew隔离运行，静待Drupal 11 alpha阶段才可能迎来PHP 8.4支持，而PHP 8.5适配至少滞后一个大版本周期。

Drupal 10 是否支持 PHP 8.5？

不支持。截至 Drupal 10.3（当前最新稳定版），官方明确只支持到 PHP 8.3，PHP 8.4 尚未进入正式支持列表，PHP 8.5 还未发布（PHP 8.5 预计 2025 年 11 月发布），更不存在兼容性测试或声明。

• Drupal 核心的 composer.json 中 "php": "^8.1 || ^8.2 || ^8.3" 是硬性约束，composer install 在 PHP 8.5 下会直接报错退出
• 模块生态几乎全部未适配：即使你绕过 Composer 强制运行，drush cr 或前端请求大概率触发 Deprecated: Return type of ... must be compatible with ... 类错误——这是 PHP 8.4+ 对返回类型推导和联合类型语义收紧导致的，Drupal 10.3 的核心类尚未覆盖这些变更
• 官方 issue 队列中（如 issue #3429876）已确认 PHP 8.4 支持工作刚启动，PHP 8.5 远未排期

想提前试跑 PHP 8.5，实际会卡在哪儿？

不是“能不能装”，而是“哪一步先崩”。真实阻断点往往比预期更早：

• composer create-project drupal/recommended-project 直接失败：Composer 自身在 PHP 8.5 下可能因反射 API 变更而无法解析 Drupal 的 autoload 规则
• 即使用 COMPOSER_DISABLE_XDEBUG_WARN=1 composer install --ignore-platform-req=php 强行装完，index.php 加载时就会抛出 Fatal error: Unknown named parameter $foo —— 这是 PHP 8.5 移除了对动态命名参数的宽松解析，而 Drupal 10.3 中仍有模块（如 devel、twig_tweak）使用了 ...$args + array_merge() 模拟命名参数的写法
• 数据库层也踩坑：mysqli 扩展在 PHP 8.5 中默认禁用 mysqlnd 的旧式字段类型映射，导致 DatabaseStatementBase::fetchAllKeyed() 返回空数组，后台内容列表直接空白

有没有临时绕过方案？

有，但代价高、不可上线，仅限本地验证思路：

• 必须用 php -d zend_extension=xdebug.so -d opcache.enable=0 启动 CLI，否则 OPcache 会缓存错误的类型签名
• 替换核心中所有 function foo(): void 为 function foo(): ?void（PHP 8.5 开始 void 不再允许隐式返回 null）
• 在 settings.php 顶部加 ini_set('error_reporting', E_ALL & ~E_DEPRECATED); —— 注意这会掩盖真正致命的 TypeError，别误以为“跑起来了”
• 模块必须锁死版本："drupal/core": "10.3.0" + "drupal/devel": "5.1.1"，新版本反而更激进地用了 PHP 8.4 特性

现在该做什么？

等。不是等“某个补丁”，而是等 Drupal 官方发布首个标记为 supports-php-8.4 的 beta 版本（预计 Drupal 11 alpha 阶段才会带 PHP 8.4 支持），PHP 8.5 的适配必然滞后至少一个大版本周期。

• 现在升级 PHP，建议停在 8.3.13（最后一个 8.3.x 安全维护版）
• 如果服务器已预装 PHP 8.5，不要尝试降级 PHP，而是用 phpbrew 或 docker run --rm -v $(pwd):/var/www/html php:8.3-cli 隔离运行环境
• 最容易被忽略的一点：Drupal 10 的 .htaccess 和 nginx.conf 示例配置里硬编码了 php-fpm83 socket 路径，换成 8.5 后不改路径会导致 502，但错误日志里只显示 connect() failed (111: Connection refused)，根本看不出是 PHP 版本问题

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP8.5与Drupal10兼容性测试报告》文章吧，也可关注golang学习网公众号了解相关技术文章。