首先确认错误提示中缺失的扩展名，如ext-gd或pdo_mysql；接着通过php -v、php -m和php --ini检查PHP版本、已加载扩展及配置文件路径；根据操作系统安装对应扩展：Ubuntu/Debian使用apt install php-扩展名，CentOS/RHEL用yum或dnf，macOS用brew安装对应扩展包，Windows则在php.ini中取消注释extension=扩展并确保dll存在；必要时重启Web服务；若仅需临时跳过可使用composer install --ignore-platform-reqs；最后验证扩展是否加载成功并重试composer install。
当你在使用 Composer 安装或更新 PHP 项目依赖时，遇到类似 "The requested PHP extension ... is missing" 的错误，说明你的 PHP 环境缺少某个扩展（如 ext-gd、ext-pdo、ext-curl 等）。以下是解决该问题的几种有效方法。
确认缺失的扩展名称
错误信息通常会明确指出缺少哪个扩展，例如：
- The requested PHP extension ext-imagick * is missing from your system.- The requested PHP extension pdo_mysql is missing.
记下这个扩展名，接下来根据系统环境进行安装。
检查当前 PHP 配置和版本
确保你操作的是正确的 PHP 版本，尤其是在服务器上安装了多个 PHP 版本时：
立即学习“PHP免费学习笔记（深入）”；
- 运行 php -v 查看当前 CLI 使用的 PHP 版本
- 运行 php -m 查看已加载的扩展列表
- 运行 php --ini 查看 php.ini 文件路径
确认你修改的是命令行使用的 php.ini，因为 Web 和 CLI 可能使用不同的配置文件。
安装缺失的 PHP 扩展
根据操作系统选择对应的方法：
Ubuntu / Debian 系统：
- 使用 apt 搜索可用扩展： apt search php-\* | grep 扩展名
- 安装扩展，例如： sudo apt install php-gd # 安装 GD 扩展
sudo apt install php-mysql # 安装 MySQL/PDO 扩展
sudo apt install php-imagick # 安装 ImageMagick 扩展
CentOS / RHEL / Fedora：
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 使用 yum 或 dnf： sudo yum install php-gd
sudo dnf install php-mbstring
macOS（使用 Homebrew）：
- 如果你通过 brew 安装 PHP： brew install php@8.1-gd # 示例，具体取决于 PHP 版本
- 某些扩展可能需要手动启用，编辑 php.ini 添加： extension=gd
Windows 系统：
- 打开 php.ini 文件（通常位于 PHP 安装目录）
- 找到并取消注释对应的 extension 行，例如： ;extension=php_gd → extension=php_gd
- 确保 php/ext/ 目录中存在对应的 .dll 文件
- 重启 Web 服务（如 Apache 或 Nginx）
跳过平台需求（临时方案）
如果只是想忽略扩展检查（不推荐生产环境使用），可加参数：
composer install --ignore-platform-reqs或只忽略特定扩展：
composer install --ignore-platform-req=ext-imagick这适合本地开发测试，但可能引发运行时错误。
验证并重试
安装扩展后，再次运行：
php -m | grep 扩展名确认扩展已加载，然后重新执行 Composer 命令：
composer install基本上就这些。关键是确认缺失的扩展、正确安装并确保 PHP CLI 能加载它。多数情况下，补上扩展后问题即可解决。
