根本原因是CI实际PHP版本与composer.json中config.platform.php声明的不一致；需显式设置platform.php匹配CI环境，并确保扩展齐全、cache key含PHP版本、禁用CI中的update命令。
CI里Composer报错“Your requirements could not be resolved”
根本原因不是依赖写得不对，而是CI默认PHP版本和composer.json里config.platform.php或require.php声明的不一致。比如本地用PHP 8.2开发，CI跑在PHP 7.4上，Composer直接拒绝装包——它连解析#[Attribute]语法都做不到。
实操建议：
- 在
composer.json中显式声明config.platform.php，例如："config": { "platform": { "php": "8.2.10" } }这不是“模拟”，而是强制Composer按这个版本做依赖解析，跳过运行时检测 - 不要只靠
require.php（如"php": "^8.2"），它只控制安装后校验，不参与前期解依赖；platform.php才管解依赖阶段 - CI脚本里别用
php --version验证PHP是否“对”，要确认which php输出的路径是否被Composer实际调用——某些CI镜像里php是symlink，指向的是系统默认版本而非你装的那个
GitHub Actions里用php-actions/composer却还是用了错误PHP版本
这个Action本身不决定PHP版本，它只是封装了composer install命令；真正起作用的是前一步shivammathur/setup-php或actions/setup-php选的版本。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 写了
with: { php-version: '8.2' }，但没加extensions参数，导致mbstring、curl等扩展缺失，Composer中途退出，看起来像版本错了 - 多个
setup-php步骤叠加，后一个会覆盖前一个，尤其在matrix策略下容易漏掉某条分支的配置 - 用了
cache: composer但没把PHP版本号打入cache key，导致PHP 8.1缓存被PHP 8.2流程误用，解出的vendor/里混着不兼容的类
正确做法：cache key必须包含PHP版本，例如composer-${{ hashFiles('**/composer.lock') }}-${{ matrix.php-version }}
GitLab CI用docker镜像，但composer install总提示“PHP extension zip not loaded”
很多PHP官方镜像（如php:8.2-cli）默认不启用常用扩展，而Composer自身不报扩展缺失，直到某个包的install脚本（比如symfony/flex）调用ZipArchive才炸。
解决路径很直接：
- 在
before_script里补全扩展：docker run --rm -v $(pwd):/app -w /app php:8.2-cli docker-php-ext-install zip && composer install
注意：docker-php-ext-install必须在容器内执行，宿主机装没用 - 如果用
php:8.2-cli-slim，它连docker-php-ext-install命令都没有，得先apt-get update && apt-get install -y zlib1g-dev再编译 - 别信
php -m | grep zip返回空就代表没装——有些镜像把zip编译成shared module，但没写进php.ini，得手动echo "extension=zip.so" >> /usr/local/etc/php/conf.d/docker-php-ext-zip.ini
本地能装，CI里composer update死循环卡住
这不是网络问题，大概率是platform.php设太高，而CI里PHP实际版本更低，Composer在回退尝试过程中陷入无效重试。比如设了"8.3.0"，但CI只有8.2.8，它会反复尝试找“勉强可用”的包版本，耗时暴涨甚至超时。
判断方法很简单：加-vvv参数跑一次，看日志里反复出现的Resolving dependencies through SAT后面是不是跟着大量Trying require php ~8.3.0。
应对方式：
-
platform.php值必须≤CI实际PHP版本，宁低勿高。生产环境PHP版本由运维定，开发不能拍脑袋填 - CI里别用
composer update，固定用composer install --no-interaction --prefer-dist；update只应在本地人手操作，CI只认lock文件 - 如果真要CI跑update（比如夜间自动同步依赖），务必加
--ignore-platform-reqs，但此时必须确保platform.php已删或注释，否则冲突更隐蔽
最麻烦的其实是PHP版本和扩展状态在不同CI平台间不透明——有的显示php -v就完事，有的得php -i | grep configure才能看到编译参数。别假设“它应该有”，查清楚再配。
