composer不负责跨版本接口协议层兼容，仅管理依赖解析；真正兼容需控制php解析器版本、显式声明platform约束，并手动隔离高版本特性。
不能靠 Composer 自动做跨版本接口协议层兼容，它只管依赖解析，不管运行时语法或函数可用性；真正的兼容必须由你控制 PHP 解析器版本 + 显式声明平台约束 + 手动隔离高版本特性。
composer install 成功但接口调用直接 ParseError 怎么办
这是最典型的误判：以为 composer install 过了就万事大吉。其实 Composer 只校验了「当前 php -v 版本下能否装得上」，而接口层一旦用了 PHP 8.1+ 的 match、readonly 或联合类型，低版本 PHP 运行时根本过不了词法分析。
- 立刻检查报错位置是否含新语法——不是依赖问题，是 PHP 解释器版本和代码不匹配
- 确认接口入口文件（如
api/index.php）实际运行在哪个 PHP 版本：php -v和 Web 服务器（如 Nginx + php-fpm）的php-fpm配置必须一致 - 别信
config.platform.php能“兜底”：它只影响composer update时选哪个包，不改变match()在 PHP 7.4 里不存在的事实 - Web 环境下，
phpinfo()比终端php -v更真实——终端和 fpm 常用不同二进制
如何让同一套接口代码在 PHP 7.4/8.1/8.3 下都跑通
核心是分层：协议层（输入/输出结构）保持稳定，实现层按 PHP 版本分支加载。Polyfill 是辅助，不是主力。
- 用
function_exists('str_contains')包裹所有 PHP 8.0+ 新函数调用，fallback 到strpos($haystack, $needle) !== false - 避免在接口响应构造逻辑中直接写
match ($status) { 'ok' => new OkResponse(), ... }；改用传统if/else或查表数组 - 把版本敏感逻辑抽到独立类，如
PhpVersionDependentSerializer，通过version_compare(PHP_VERSION, '8.1', '>=')实例化不同子类 - 安装对应 polyfill 子包：需要
json_validate()就composer require symfony/polyfill-php80，别只装symfony/polyfill元包（它啥也不提供）
CI 中验证多 PHP 版本接口协议兼容性的实操要点
本地能跑 ≠ CI 能过 ≠ 线上能用。CI 必须模拟真实部署环境，而不是仅换 php 命令。
- GitHub Actions 中用
shivammathur/setup-php@v2指定 PHP 版本，并显式设置fpm: true（如果测试的是 Web 接口） - 每个 job 执行前删掉
vendor/和composer.lock，再用目标 PHP 二进制跑：/usr/bin/php8.1 /path/to/composer.phar install --no-interaction - 接口测试脚本（如 PHPUnit 或 Pest）必须包含运行时断言：例如
$this->assertEquals('application/json', $response->header('Content-Type'))，不能只测 HTTP 状态码 - 在
composer.json的config.platform.php里设为最低支持版本（如"7.4.0"），强制锁文件记录该版本下可装的依赖组合——这能提前暴露symfony/http-foundation ^6.0这类不兼容包
为什么 config.platform.php 设成 "8.2" 后 vendor 里还是有 PHP 7.4 兼容代码
因为 config.platform.php 不控制源码内容，只控制 Composer「能选哪些包版本」。一个包只要声明支持 PHP 8.2，Composer 就会装它，哪怕它的代码里写了 if (PHP_VERSION_ID >= 80200) { ... } 这种条件逻辑。
- 真正决定代码是否兼容的，是包作者写的运行时判断，不是 Composer 的平台配置
- 如果你发现某个包在 PHP 8.2 下装了却在 PHP 7.4 下报错，说明它没做好向后兼容——这不是 Composer 的责任，是包本身的问题
- 此时应降级该包（如用
"monolog/monolog": "^2.9"替代"^3.0"），或提交 issue 要求作者补 polyfill - 永远不要把
config.platform.php提交到共享仓库：队友本地 PHP 是 8.3，他composer install装的包可能带match，你拉下来在 8.1 下直接崩
最关键的盲点：协议层兼容不是“让旧 PHP 跑新语法”，而是“让新旧 PHP 都能执行同一套契约逻辑”。这要求你在写第一个接口路由时，就决定好哪些语言特性绝对不用，而不是等 ParseError 报出来再改。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
