不支持。drupal 10.3 官方仅支持 php 8.1–8.3,php 8.4 尚未正式支持,php 8.5(2025年11月发布)更无兼容性测试或声明,composer.json 硬性约束及核心代码均未适配。

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免费学习笔记(深入)”;
- 现在升级 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-fpm83socket 路径,换成 8.5 后不改路径会导致 502,但错误日志里只显示connect() failed (111: Connection refused),根本看不出是 PHP 版本问题











