应使用--ignore-platform-req=php或--ignore-platform-req=ext-gd精准跳过指定平台项，避免用--ignore-platform-reqs（带s）导致所有平台检查失效，引发运行时错误。
composer install 报 platform requirements mismatch 怎么办
直接加 --ignore-platform-req=php 或 --ignore-platform-req=ext-gd，别用 --ignore-platform-reqs（带 s）。前者只绕过你明确指定的那一项，后者会跳过所有平台检查——包括 PHP 版本、ext-openssl、lib-libxml 等，极易导致运行时报 Fatal error: Call to undefined function curl_init()。
常见错误现象：
-
Root composer.json requires php ^8.2 but your php version (8.0.30) does not satisfy that requirement→ 用--ignore-platform-req=php -
The requested PHP extension gd is missing from your system→ 先运行php -m | grep gd确认输出是gd，那扩展名就是ext-gd，再用--ignore-platform-req=ext-gd -
--ignore-platform-req=gd报错 unrecognized option → 拼写必须和php -m输出完全一致，不是gd，也不是php-gd
多个平台项要忽略，怎么写命令
每个 --ignore-platform-req 参数必须单独写一次，等号右边不能拼接多个值。
- 只忽略 PHP 版本：
composer install --ignore-platform-req=php - 同时忽略 PHP 和 GD：
composer install --ignore-platform-req=php --ignore-platform-req=ext-gd - 忽略 GD 和 mbstring：
composer install --ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring - 错误写法：
--ignore-platform-req=php,ext-gd（无效）或--ignore-platform-req php ext-gd（无等号 = 等价于--ignore-platform-reqs）
该参数对 composer create-project 同样有效，比如拉 Laravel 时缺 zip：composer create-project laravel/laravel --ignore-platform-req=ext-zip。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
config.platform 能代替命令行参数吗
可以，但仅对 composer update 生效，且对 composer install 完全无效。
- 想“假装”有
ext-gd："config": {"platform": {"ext-gd": "8.1.0"}}—— 值可任意，Composer 不校验真实性 - 改完必须跑
composer update --lock才能让新配置写入composer.lock -
composer install只读composer.lock，根本不看composer.json里的config.platform - 不推荐提交到团队仓库：别人真实有
ext-gd的机器也会被“模拟”，掩盖环境差异
忽略后运行时报 Class not found 或函数未定义
说明问题根本不在安装阶段——--ignore-platform-req=ext-gd 只让 Composer 放行，但运行时 gd 函数确实不存在。某些 polyfill（如 symfony/polyfill-gd）会因检测不到扩展而跳过加载，导致功能缺失。
- 这不是 Composer 的错，而是你跳过了真实依赖的校验
- CI/CD 中尤其危险：构建镜像用了
--ignore-platform-reqs，但 runtime 镜像没装ext-curl，一运行就崩 - 真正需要的不是“跳过全部”，而是“只放过我知道无害的那一项”；如果连运行时都用不到 GD，那就别装依赖它的包
最易被忽略的一点：报错信息里出现 platform requirements mismatch 才是平台问题，而 could not resolve packages 或 Conclusion: don’t install X 是依赖逻辑冲突，--ignore-platform-req 对后者完全无效。
