composer install 报该错误是因为当前 php 环境缺失 composer.json 中声明的必需扩展（如 ext-redis），需通过 php -m 确认缺失项，并在对应 php.ini 中启用或系统级安装该扩展，临时忽略参数仅跳过检查，不解决运行时问题。
为什么 composer install 报 “Root composer.json requires PHP extension” 错误
这个提示不是警告，是硬性拦截——Composer 检测到当前 PHP 环境缺失 composer.json 中 require 或 require-dev 里声明的扩展（如 ext-gd、ext-mbstring），直接中止安装。常见于：本地 PHP 版本低、扩展未启用、Docker 容器未装扩展、或 CI 环境精简镜像漏配。
确认缺失的是哪个扩展
错误信息末尾会明确写出扩展名，例如：
Root composer.json requires PHP extension ext-redis but it is missing from your system.
重点看 ext-xxx 这部分。不要凭经验猜——ext-intl 和 ext-iconv 常被忽略，但 Laravel、Symfony 等框架实际依赖它们。
- 用
php -m查已启用扩展 - 用
php -i | grep "Loaded Configuration File"找到php.ini路径，再检查该文件是否含extension=xxx.so（Linux/macOS）或extension=php_xxx.dll（Windows） - 注意 CLI 和 Web SAPI 的
php.ini可能不同，composer install走的是 CLI 模式
快速修复：启用或安装缺失扩展
根据系统环境选择对应操作，别跳过验证步骤：
立即学习“PHP免费学习笔记（深入）”；
- Ubuntu/Debian：
sudo apt install php-redis（自动启用），然后sudo systemctl restart apache2或sudo service php8.1-fpm restart - macOS + Homebrew：
brew install php@8.2后执行echo "extension=redis.so" >> /opt/homebrew/etc/php/8.2/php.ini - Docker（Alpine）：
RUN apk add php82-pecl-redis，并确保docker-php-ext-enable redis在构建阶段执行 - Windows（XAMPP/WAMP）：打开
php.ini，取消注释对应行（如;extension=php_gd2.dll→ 改为extension=php_gd2.dll），重启 Apache
改完务必运行 php -m | grep redis（把 redis 换成你要查的扩展名）确认生效。
临时绕过（仅限开发调试，勿用于生产）
如果只是想快速跑通依赖安装（比如临时测试某包），可用 --ignore-platform-req 参数：
composer install --ignore-platform-req=ext-redis
或忽略全部扩展检查（风险更高）：
composer install --ignore-platform-req=ext-*
但要注意：--ignore-platform-req 不解决运行时问题——扩展没装，后续 php artisan serve 或 php index.php 仍会报 Call to undefined function redis_connect() 这类致命错误。
扩展缺失是运行时依赖，不是 Composer 构建期可妥协的点。最省事的“修复”，往往在真正启用扩展那一步就结束了。
