Composer install失败主因是CLI与Web环境PHP版本不一致，需用composer show --platform和which php确认实际版本，再通过config.platform.php锁定目标版本或指定php路径执行。
直接用 composer install 在 PHP 8.3 环境下失败，大概率不是 Composer 不支持，而是它没按你预期的 PHP 版本去选包——你得手动告诉它“目标环境是 8.3”，否则它默认信任当前 CLI 的 php 命令，而这个命令可能指向旧版本、缺扩展，或根本没对齐 Web SAPI。
怎么确认 Composer 实际用的是哪个 PHP 版本
别只信 php -v，它只是 shell 当前 PATH 下的第一个 php。Composer 读的是它启动时实际调用的解释器，可能完全不同。
- 运行
composer show --platform，看输出里的php行——这才是 Composer 自己感知到的版本和已加载扩展 - 执行
which php（macOS/Linux）或where php（Windows），检查第一个路径是否真指向 PHP 8.3 安装目录 - 如果两者不一致，说明 Composer 没走你装的 8.3，而是用了系统自带或其他版本（比如 Ubuntu 自带的 8.1）
- 临时验证：用完整路径强制调用，例如
/usr/bin/php8.3 /path/to/composer.phar install
为什么写了 "php": "^8.3" 还装不上依赖
写得太窄，等于主动把主流生态挡在外面。Packagist 上绝大多数稳定包（如 monolog/monolog、guzzlehttp/guzzle）目前仍标 "php": "^8.0" 或 "^8.1 || ^8.2"，还没发明确要求 ^8.3 的正式版。
- 改写为
"php": "^8.2"或"php": ">=8.2.0 更现实，既守住底线，又留出兼容空间 -
"php": "^8.3"会导致 Composer 找不到任何候选版本，报错类似Could not find a version of package xxx matching your minimum-stability - 若项目必须用 PHP 8.3 新特性（如
readonly class），那就得接受部分依赖尚未适配，优先升级到已声明支持 8.3 的包主版本（比如symfony/console:^6.4）
如何让 Composer 在任意环境都按 PHP 8.3 解析依赖
靠 config.platform.php，不是模拟，是硬性约束——它让 Composer 忽略当前 CLI 版本，只按你指定的平台条件筛选包。
立即学习“PHP免费学习笔记（深入）”；
- 执行
composer config platform.php 8.3.0，该配置会写入composer.json的config段 - 必须写完整小版本号
8.3.0，写"^8.3"或">=8.3"会被静默忽略 - 这条配置可提交到 Git，确保 CI 和队友行为一致；但要注意：它只影响
install/update阶段，不解决运行时语法错误 - 设完后删掉
vendor和composer.lock，再跑composer install，否则 lock 文件里还是旧解析结果
CI/CD 构建时最容易踩的坑
本地能过，CI 报错，往往是因为镜像选错了——composer:latest 默认绑 PHP 8.3+，但你的项目锁的是 "php": "^8.1"，它照样装，直到运行时报 ParseError: syntax error, unexpected token "match"。
- 别用
composer:latest，改用匹配的官方 PHP 镜像，例如FROM php:8.1-cli（Laravel 9）或FROM php:8.2-apache（Laravel 10） - 在 Dockerfile 里手动装 Composer：
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - CI 脚本里加一句
php -v && composer --version，确认两者版本对得上，避免多阶段构建中 PHP 版本漂移 - 如果要用
--ignore-platform-reqs，仅限调试，生产环境禁用——它跳过检查，但不修复问题
真正卡住的从来不是 Composer 本身，而是 PHP CLI、Web SAPI、扩展、PATH 四者没对齐；config.platform.php 只管安装逻辑，readonly class 这类语法错误，永远发生在运行时，且只认真实 PHP 版本，不认配置文件里写的数字。
