应使用--ignore-platform-req=php或--ignore-platform-req=ext-gd精准跳过指定平台项，避免用--ignore-platform-reqs（带s）导致所有平台检查失效而引发运行时错误。
composer require 时怎么跳过平台检查
直接加 --ignore-platform-req=php 或 --ignore-platform-req=ext-gd，和 composer install 用法一致——require 命令底层仍走完整依赖解析与平台校验流程，不跳过就卡在第一步。
为什么 --ignore-platform-reqs 在 require 里风险更高
composer require 不只是“装一个包”，它会重新计算整个依赖树，一旦用 --ignore-platform-reqs（无等号、无值），就会同时跳过 PHP 版本 + 所有扩展检查，极易引入运行时崩溃：
- 比如你本地没装
ext-swoole，但require laravel/octane成功了，后续php artisan octane:start直接报Class 'Swoole\Http\Server' not found - 又比如项目声明
"php": "^8.1"，你用 PHP 8.0 强行require一个只支持 8.1+ 的包，装完跑测试时遇到str_contains()就 fatal error -
--ignore-platform-reqs还会让 Composer 装上本该被排除的旧版依赖（如symfony/consolev5.4），而新版 Laravel 可能已弃用其 API
更安全的 require 跳过方式
优先按需指定，别一把梭：
- 只跳 PHP 版本：
composer require monolog/monolog --ignore-platform-req=php - 只跳某个扩展（比如开发机没装
ext-redis，但你确定当前阶段不用缓存）：composer require predis/predis --ignore-platform-req=ext-redis - 跳多个项可叠加：
composer require laravel/framework --ignore-platform-req=php --ignore-platform-req=ext-zip - 值必须严格匹配
php -m输出的名称，ext-curl不能写成curl或php-curl
require 后运行时报错，大概率不是 require 阶段的问题
如果 composer require 成功了，但后续执行命令（如 vendor/bin/phpunit）失败，别回头改 require 参数——那是工具自身做的运行时校验，和 Composer 安装无关：
- 例如
phpunit的composer.json里写了"php": "^8.1"，你本地是 8.0，它启动时自己拒绝运行，--ignore-platform-req=php对它完全无效 - 这类问题得换 PHP 版本，或找兼容低版本的工具替代（如降级
phpunit版本） - 真正该警惕的是：require 成功后，
composer install却报Your lock file does not contain a compatible set of packages——这说明require改动了composer.json，但composer.lock没同步更新，此时要删 lock 文件或跑composer update --lock
