config.platform是唯一稳定控制composer依赖解析目标php环境的配置，必须置于composer.json的config对象内，仅影响install/update阶段选包逻辑，不改变运行时环境或安装扩展；需手动声明php版本及ext-*扩展，写错位置或漏配将导致ci失败或线上崩溃。
config.platform 是唯一能稳定控制 Composer 依赖解析所用 PHP 环境的配置项，但它不改你本地 php 命令、不装扩展、也不影响运行时行为——只在 composer update 阶段起作用。
config.platform 必须写在项目 composer.json 的 config 字段里
很多人把 platform 写成独立文件（比如 platform.php），或塞进全局配置（composer config -g platform.php 8.1），结果 CI 失败、同事装不上、本地生效线上崩。原因很直接：config.platform 只在项目根目录的 composer.json 中定义才被 Composer 正确识别和提交。
- 正确位置：
composer.json同级于require和autoload，嵌套在"config": { "platform": { ... } }里 - 错误做法：写成
"config.platform.php"（字段不存在）、或往~/.composer/config.json里硬塞（污染全局，协作灾难） - 验证是否生效：运行
composer config --list | grep platform，看到输出带(local)标记才算对
只设 php 版本不够，扩展必须手动列全
"php": "8.1.25" 不代表 ext-mbstring、ext-sodium 就自动“存在”。Composer 不读你本地的 php.ini，它只认你明确写进 platform 的项。一旦某个包 require "ext-sodium": "*"，而你没声明，composer install 就会报错。
- 必须补全常见扩展：
"ext-sodium": "*"、"ext-mbstring": "*"、"ext-openssl": "*"、"ext-json": "*" - 扩展名严格是
ext-xxx，不是php-xxx或xxx - 版本号填
*可行，但建议填具体值（如"8.1.25"），避免某些包校验逻辑误判
--ignore-platform-reqs 是临时止痛药，不是解药
遇到 Your requirements could not be resolved 就加 --ignore-platform-reqs？这等于让 Composer 盲装——可能装上 PHP 8.2 才有的函数调用，部署到 PHP 8.1 服务器直接 Fatal error: Uncaught Error: Call to undefined function。
- 仅限调试：确认问题是否真出在 platform 配置上，用完立刻删掉
- CI/CD 构建绝对禁用：它绕过所有平台约束，失去提前发现兼容性问题的意义
- 真正该做的是：对照生产环境
php -v和php -m输出，把config.platform补完整
config.platform 不影响运行时，只骗过依赖解析
哪怕你设成 "php": "7.4.0"，本地 PHP 8.3 依然能跑起来——但只要某行代码用了 match 表达式，PHP 7.4 环境就必然崩。这是最容易被忽略的一点：platform 不装扩展、不改 php 命令、不干预任何运行时行为，它只在 composer update 阶段告诉依赖解析器：“请按这个环境选包”。
真实缺失扩展仍会崩：设了 "ext-gd": "8.1.0"，但系统没装 gd 扩展，运行时调用 imagecreate() 还是报 Call to undefined function。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
