PHP 5.4 环境下必须降级 symfony/（v4.4）、monolog/monolog（v1.27.2）、guzzlehttp/guzzle（v6.5.5）、doctrine/（DBAL v2.13.x、ORM v2.11.x）等包，因高版本含 PHP 5.4 不支持的语法（如 match、联合类型），polyfill 无法修复，需精确锁定版本并用 Composer 1.10.x 生成 autoload。
PHP 5.4 环境下直接装 symfony/console v6 或 monolog/monolog v3 会失败，不是因为 Composer 拒绝安装，而是这些包根本没为 PHP 5.4 编译兼容代码——它们的源码里有 string|int 类型声明、match 表达式等语法，PHP 5.4 解析器直接报 ParseError。所谓“桥接”，本质是绕过高版本包，换用仍支持 PHP 5.4 的旧版实现，并补足缺失功能。
哪些包必须降级才能跑通 PHP 5.4
别猜，直接查：运行 composer show --platform 确认当前是 php: 5.4.x，再执行 composer depends --tree php 看哪些依赖在拉高 PHP 要求。重点盯以下几类：
-
symfony/*：v4.4 是最后一个完整支持 PHP 5.4 的主版本（v5+ 全线放弃） -
monolog/monolog：v1.27.2 是最后支持 PHP 5.3–5.6 的版本，v2+ 要求 PHP 7.2+ -
guzzlehttp/guzzle：v6.5.5 是最后一个兼容 PHP 5.4 的版本（v7+ 需 PHP 7.2.5+） -
doctrine/*：Doctrine DBAL v2.13.x 和 ORM v2.11.x 是 PHP 5.4 可用的最终版本
注意：laravel/framework v5.8 是最后一个支持 PHP 5.4 的版本，但它的子依赖（如 symfony/http-foundation）可能偷偷升级到 v4.4 以上，得一起锁死。
composer.json 中锁定兼容版本的关键写法
不能只写 "monolog/monolog": "^1.27" —— ^1.27 允许升到 1.28.0，而该版本已移除 PHP 5.4 支持。必须用精确版本或带上限的约束：
立即学习“PHP免费学习笔记（深入）”；
- 用具体版本号：
"monolog/monolog": "1.27.2" - 用波浪线加上限：
"symfony/console": "~4.4.0", "symfony/event-dispatcher": "~4.4.0" - 禁用自动升级：在
config段加"preferred-install": {"*": "dist"}，避免 dev 版本混入
同时删掉 config.platform.php 字段（如果存在），它会误导 Composer 按更高版本解析依赖；PHP 5.4 环境下，这个字段毫无意义，反而制造冲突。
polyfill 不是万能解药，有些语法根本补不了
symfony/polyfill 系列能补函数（如 mb_str_split）、类（如 Stringable），但补不了语言结构：
-
??、?:这类三元简写在 PHP 5.4 是合法的，不用补 -
yield from、finally、trait在 PHP 5.4 已存在，也不需 polyfill - 但
fn() =>箭头函数、match表达式、联合类型string|int、属性初始化public string $name = ''—— 这些在 PHP 5.4 完全不识别，polyfill 无法转换，只能换包
所以看到错误信息含 Parse error: syntax error, unexpected 'match' 或 unexpected '?' in ...（注意：这是 PHP 5.4 报的 ?，不是空合并操作符，而是 ?? 前的语法糖未被识别），说明你装的包源码本身就不兼容，polyfill 无效，必须降级。
vendor/autoload.php 加载失败的真实原因
即使所有包都降级成功，require 'vendor/autoload.php' 仍可能报 Class not found。这不是 Composer 没装好，而是 autoloader 生成逻辑与 PHP 版本强绑定：
- Composer 2.x 默认生成的 autoloader 会用 PHP 7.4+ 的 opcache 优化路径，PHP 5.4 加载时跳过 classmap 导致找不到类
- 解决方案：用 Composer 1.10.22（最后支持 PHP 5.3–5.6 的版本）重新生成 autoload：
php composer.phar dump-autoload - 验证：打开
vendor/autoload.php，搜索class_exists或opcache—— 如果有，说明是高版本生成的，必须重装
真正麻烦的从来不是“怎么装”，而是“装完能不能跑”。PHP 5.4 的边界很硬：语法不支持就是不支持，没有中间态。每换一个包，都要跑一次 php -l vendor/<em>package</em>/src/*.php 手动抽检，否则上线后第一个请求就 ParseError。
