Composer不支持安装系统级组件。它仅管理PHP包依赖，通过extension_loaded()检查扩展是否存在，但不会调用apt/yum/brew等命令安装libgd、php-mysql等系统扩展，需手动用系统包管理器安装并确保PHP正确加载。
不支持。Composer 从设计上就只管 PHP 代码依赖，它不会、也不能安装或管理 libgd、imagemagick、php-mysql 这类系统级组件。
为什么 composer install 不会自动装 apt/yum/brew 能装的东西
Composer 的核心职责是下载和组织 PHP 包（比如 monolog/monolog），并生成 vendor/autoload.php。它调用的是 PHP 的 file_get_contents() 和 zip_extract() 等函数，不是系统 shell 命令。它压根不调用 apt install 或 brew install，也没有权限或配置机制去触发这些操作。
常见误解是看到 "ext-gd": "*" 就以为 Composer 会装 GD —— 实际上它只是检查 extension_loaded('gd') 是否为 true；如果返回 false，就报错中断，但绝不会帮你去装 libgd-dev 或启用 extension=gd.so。
如何让 ext-gd、ext-pdo 这类依赖真正可用
必须分两步走：先由系统包管理器装底层库和扩展，再确保 PHP 加载它们。顺序错了或漏了哪一步，composer install 都会失败。
- Ubuntu/Debian：
sudo apt install php-gd php-mysql php-xml php-zip php-curl php-mbstring（注意：不是libgd-dev，那是编译 PHP 时需要的；运行时只需要php-gd） - CentOS/RHEL 8+：
sudo dnf install php-gd php-mysqlnd php-xml php-zip php-curl php-mbstring - macOS + Homebrew：
brew install php（它自带常用扩展），再确认php -m | grep gd有输出 - 装完后记得重启 Web 服务或 CLI：Apache 用户执行
sudo systemctl restart apache2，PHP-FPM 用户执行sudo systemctl restart php*-fpm
composer.json 里写 "ext-gd": "*" 的真实作用
这不是安装指令，而是环境守门员。它的唯一作用是在 composer install 或 composer update 时做一次 extension_loaded() 检查。一旦失败，立刻抛出类似这样的错误：
Required extension gd is missing from your system.
这个检查发生在依赖下载之后、自动加载生成之前，所以它能防止你“成功安装却运行报错”的尴尬场景。但它不解决缺失问题——那得靠你手动补全系统层依赖。
最容易被忽略的一点：PHP CLI 和 Web Server 使用的 php.ini 往往不是同一个文件。你在终端跑 php -m | grep gd 有结果，不代表 Apache 或 Nginx 下的 PHP 也加载了该扩展。务必用 phpinfo() 页面确认 Web 环境实际加载的模块。
