答案是报错中“ext-xxx”的xxx即缺失扩展名，需用php -m | grep xxx验证cli环境是否加载；cli与web配置分离，必须修改对应php.ini或启用模块，--ignore-platform-reqs仅跳过校验不解决运行时问题。
直接看报错末尾的 ext-xxx，用 php -m | grep xxx 验证 CLI 是否真缺——不是 Composer 有问题，是 PHP 没加载模块。
怎么一眼锁定缺失的扩展名
报错里那句 “Root composer.json requires PHP extension ext-redis but it is missing from your system.” 不是提示，是结论。重点只看 ext-redis 这部分，别被 “requires”“but” 带偏。
- 常见被忽略但硬依赖的扩展：
ext-dom、ext-fileinfo、ext-intl、ext-mbstring、ext-xml、ext-zip - 错误里如果出现多个 Problem 1、Problem 2，优先处理第一个——后面往往是连锁反应，比如没
ext-xml，ext-dom就根本加载不了 - 复制报错里的名字（如
fileinfo），直接用于后续命令，不拼写、不猜测
为什么 php -m 没看到，但浏览器 phpinfo() 里有
因为 CLI 和 Web（Apache/FPM）用的是两套独立的 PHP 配置。Composer 走的是 CLI 模式，只认 php -m 的输出，和网页里看到的完全无关。
- 运行
php --ini，盯住这一行：Loaded Configuration File: /etc/php/8.2/cli/php.ini—— 这个路径才是 Composer 真正在读的配置文件 - 如果显示
(none)，说明 CLI 根本没加载任何php.ini，得手动复制一份过去 - 宝塔用户：点「软件商店」→ 找对应 PHP 版本 → 「设置」→ 「安装扩展」→ 开
fileinfo、zip等，**必须点右上角「重载配置」**（不是重启 PHP）
Linux/macOS 下装完包却 php -m 不显示扩展
常见原因是模块没启用，不是没安装。
- Ubuntu/Debian：装了
php-gd后还得运行sudo phpenmod gd（对 CLI 和 Apache 都生效） - CentOS/RHEL：检查
/etc/php.d/gd.ini是否存在且内容是extension=gd（不是;extension=gd） - macOS + Homebrew：装完
brew install php@8.2-gd后，确认php --ini指向的php.ini里有extension="gd"这一行（注意引号格式） - Windows：改
php.ini时确保extension_dir指向正确的ext/目录，且该目录下真有php_fileinfo.dll
--ignore-platform-reqs 是绕过检查，不是解决问题
加 --ignore-platform-reqs 能让 composer install 成功，但只是跳过校验，不解决运行时崩溃风险：
- 如果代码里调用了
new Redis()，而系统没装ext-redis，运行时照样报Class 'Redis' not found - 它同时跳过 PHP 版本、所有扩展、INI 设置校验，容易装入不兼容包
- 更安全的是精准忽略：
composer install --ignore-platform-req=ext-gd（只跳过 gd），或--ignore-platform-req=php（只跳过 PHP 版本） -
--ignore-platform-reqs必须放在命令末尾，否则会被当成包名解析失败
真正卡住的地方不在“怎么开”，而在“谁在用”：CLI 和 Web 用不同 PHP；php -v 和宝塔面板里网站设置的 PHP 版本不一致；Docker 或 Laravel Sail 里用的又是另一套精简镜像——这些都得逐个验证，不能只改一个地方就以为全好了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
