缺失PHP扩展时需根据报错安装对应模块。先确认缺失的扩展名，再在系统中通过包管理器或修改php.ini启用，最后验证并重启服务确保生效。
确认报错里缺的是哪个扩展
错误信息通常直接写明，比如 The requested PHP extension ext-zip is missing 或 requires ext-dom。注意看清楚是 ext-zip 还是 zip，是 ext-gd 还是 gd——Composer 要求的写法必须带 ext- 前缀，但系统包名通常不带（php-zip ✅，php-ext-zip ❌）。
验证当前 CLI 环境是否真没加载
别只信报错，也别凭记忆改 php.ini。三步快速验真：
- 运行
php -m | grep zip（把zip换成你缺的那个扩展名），无输出 = 未启用 - 运行
php --ini，看输出的 Loaded Configuration File 路径，确保你改的是这个文件 - 运行
php -r "var_dump(class_exists('ZipArchive'));"，返回bool(false)就坐实了问题
按系统装扩展，别抄错包名
不同系统、不同 PHP 安装方式，包名规则完全不同：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Ubuntu/Debian：
sudo apt install php-zip（自动写入配置，不用手动改 php.ini） - CentOS/RHEL 7：
sudo yum install php-pecl-zip；8+：sudo dnf install php-zip - Alpine（Docker）：
apk add php8-zip（PHP 版本号必须匹配php -v输出） - macOS + Homebrew：
brew install php@8.2-zip（版本号要严丝合缝） - Windows：打开
php --ini显示的 php.ini，取消;extension=zip前的分号，并确认extension_dir指向正确目录，且php_zip.dll存在
装完还要再查一层：libzip 和 unzip 命令
扩展装上 ≠ Composer 就能用。两个常被忽略的依赖：
-
libzip版本太低（如 CentOS 7 自带 0.10），PHP 8.0+ 要求 ≥ 1.6.0，否则解压时静默崩溃：运行pkg-config --modversion libzip验证 - Docker 中即使
php-zip装好了，如果基础镜像没装系统级unzip命令，Composer 默认优先调它，会卡在unzip not found：补apk add unzip或apt install unzip
真正麻烦的不是“装不上”，而是“以为装好了”——CLI PHP 加载了哪个 ini、哪个 so、依赖哪个 libzip 版本、有没有系统 unzip，漏掉任意一环，composer install 都会继续报错。
