要让 composer.json 兼容多个 PHP 版本，需在 require 中声明多版本 PHP 范围（如 "^7.4 || ^8.0 || ^8.1 || ^8.2"）和必需扩展，在 config.platform.php 中指定目标 PHP 版本以控制依赖解析，并通过 CI 多版本测试验证安装与运行。
要让 composer.json 兼容多个 PHP 版本，核心是明确声明支持的 PHP 范围，并合理约束依赖包的版本兼容性，避免因底层扩展或语法差异导致安装失败或运行时错误。
正确设置 php 平台配置
Composer 默认根据当前运行环境的 PHP 版本解析依赖，但你可能希望在低版本 PHP 环境中也能成功 install 或 update。这时应显式声明目标平台：
- 在
config.platform.php中指定最低（或目标）PHP 版本，例如"7.4"或"8.0" - 这会覆盖本地 PHP 版本，强制 Composer 按该版本解析依赖约束（如
ext-json、php >= 8.1的包将被跳过） - 注意：仅影响依赖解析，不改变实际运行环境；运行时仍需确保 PHP 版本匹配
用 require 精确限定 PHP 和扩展版本
在 require 字段中明确声明对 PHP 及关键扩展的最小要求：
-
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"—— 支持多个主版本，用||表示“或”关系 -
"ext-json": "*"或"ext-mbstring": "*"—— 确保必需扩展存在（部分扩展在不同 PHP 版本中默认开启状态不同） - 避免写死高版本如
"php": "^8.2"，除非项目确实使用了仅 8.2+ 的特性（如只读类）
为不同 PHP 版本提供分层依赖策略
某些包在不同 PHP 版本下有不同兼容分支（如 symfony/console 5.x 支持 PHP 7.2+，6.x 要求 PHP 8.0+），可用以下方式应对：
立即学习“PHP免费学习笔记（深入）”；
- 统一使用语义化版本范围，例如
"symfony/console": "^5.4 || ^6.2"，让 Composer 自动选最适配版本 - 对强版本绑定的包（如测试工具），可借助
require-dev+platform.config组合控制：CI 中分别用不同platform.php值测试各版本 - 避免在
require中混用不相交的约束（如同时要求php: ^7.4和laravel/framework: ^10.0，后者已弃用 PHP 7.x）
验证多版本兼容性的实用建议
光写对没用，得验证是否真能装、真能跑：
- 本地用
php7.4 -d extension=json.so composer install手动模拟低版本环境 - CI 中并行运行多个 PHP 版本（GitHub Actions / GitLab CI），每个任务设不同
platform.php - 检查
composer show --platform输出，确认解析出的 PHP 和扩展版本符合预期 - 若遇冲突，用
composer why-not php:8.0快速定位哪个依赖卡住了升级路径
基本上就这些。关键是把 PHP 版本当作一个“基础依赖”来管理，而不是环境假设。不复杂但容易忽略。
