应使用 --ignore-platform-req ext-zip 精准跳过 zip 扩展校验，而非粗暴的 --ignore-platform-reqs；后者会忽略所有平台依赖，易埋隐患，而前者可多次指定，如 --ignore-platform-req ext-zip --ignore-platform-req ext-gd。
composer install 时提示 ext-zip 缺失，但你确定不需要它
直接加 --ignore-platform-reqs 是最粗暴的绕过方式，但它会忽略所有扩展依赖（比如 ext-mbstring、ext-curl），容易埋雷。真要只跳过 ext-zip，得用更精准的参数。
-
--ignore-platform-reqs是全局开关，不是按扩展名过滤的——它根本不认=ext-zip这种写法，--ignore-platform-reqs=ext-zip实际上会被 Composer 当作无效参数忽略，还可能报错Unrecognized option "--ignore-platform-reqs=ext-zip" - 真正能指定忽略某扩展的是
--ignore-platform-req（注意末尾没s），支持多次使用，例如：composer install --ignore-platform-req ext-zip - 如果项目里多个扩展都缺（比如还缺
ext-gd），可以重复加：composer install --ignore-platform-req ext-zip --ignore-platform-req ext-gd
为什么不能只靠 --ignore-platform-reqs？
因为 --ignore-platform-reqs 的设计目标是“跳过全部平台约束”，适用于临时调试或 CI 环境中已确认 PHP 配置安全的场景。它不区分哪些扩展是可选的、哪些是硬依赖——只要 composer.json 里写了 "ext-zip": "*"，它就当真，哪怕你本地只是跑个命令行脚本，根本用不到 ZIP 功能。
- 某些包（如
symfony/filesystem）只在启用ext-zip时才激活 ZIP 相关方法，没这个扩展也不影响其他功能，这时精准忽略更合理 - CI/CD 中用 Docker 构建时，基础镜像可能故意不装
ext-zip来减小体积，这时候用--ignore-platform-req ext-zip比塞进一个用不到的扩展更干净 -
--ignore-platform-reqs可能掩盖真实问题：比如你忘了装ext-opcache，而它其实是性能关键项，被一并跳过就容易上线后卡顿
实际运行时常见错误和对应操作
遇到 Your requirements could not be resolved to an installable set of packages 并提示 ext-zip 不满足，别急着加全局忽略。先确认是不是真的不需要——比如你只是用 Composer 安装一个纯 PHP 工具（如 phpunit），那 ZIP 扩展确实无关紧要。
- 错误信息里出现
The requested PHP extension ext-zip * is missing from your system→ 表明composer.json或某个依赖要求了该扩展 - 执行
php -m | grep zip确认是否真没装；如果已装但 PHP CLI 和 Web 使用不同配置，需检查php --ini加载的php.ini路径 - 想验证是否仅 ZIP 导致失败，可临时删掉
vendor和composer.lock，再运行：composer install --ignore-platform-req ext-zip - 如果仍报错其他扩展缺失，说明还有别的约束，继续追加
--ignore-platform-req参数，不要切回--ignore-platform-reqs
生产环境千万别默认用 --ignore-platform-req
这个参数不会改写 composer.lock，也不会影响后续 composer update，但它会让安装过程跳过校验——相当于告诉 Composer：“信我，这环境没问题”。一旦部署到另一台机器，而那台机器连 ext-json 都没开，就会直接崩在 require 阶段。
- CI 流水线里用
--ignore-platform-req是常见做法，但必须配合明确的文档说明：哪几个扩展被跳过、为什么可跳过、是否有 fallback 逻辑 - 本地开发建议优先装齐扩展，而不是绕过；Docker 用户可在
Dockerfile中显式安装：RUN docker-php-ext-install zip -
--ignore-platform-req是一次性开关，每次install或update都得带上，没法写进配置文件永久生效
事情说清了就结束
