php -m未显示ext-zip/ext-gd说明PHP CLI环境未加载，需用php --ini定位配置文件、检查extension=zip/gd是否启用、确认extension_dir路径及对应.so/.dll文件存在，并按系统版本安装正确扩展包。
php -m 里没看到 ext-zip、ext-gd 这些怎么办
不是 Composer 错了，是 PHP CLI 环境根本没加载这些扩展。先别碰 composer install，直接跑 php -m | grep zip 和 php -m | grep gd，空输出就说明缺失真实存在。
Linux/macOS 上常见原因是 php.ini 里那行 extension=zip 被注释了，或压根没写；Windows 下则是 extension=php_zip.dll 写错名（比如写成 php_zip7.dll），或 extension_dir 指向的目录里根本没有这个 DLL 文件。
- 用
php --ini找到 CLI 实际读的配置文件路径（比如/etc/php/8.3/cli/php.ini） - 打开它，搜索
extension=zip和extension=gd，删掉前面的分号 - 确认
extension_dir的值是否指向真实存在的目录（php -r "echo ini_get('extension_dir');"），且该目录下有zip.so或php_gd.dll - 改完立刻验证：
php -m | grep -E "zip|gd"，别等重启 Web 服务——CLI 不依赖 Apache/Nginx
Ubuntu/Debian 装了 php-zip 却还是报错
多版本 PHP 共存时，php-zip 这种通用包名大概率无效。系统里装的是 PHP 8.3，但 apt 默认可能装到 8.2 或 8.1 的模块目录下，导致 php -m 看不见。
必须用带版本号的包名安装，且确认 CLI 当前版本：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -v确认是 8.3.x - 执行
sudo apt install php8.3-zip php8.3-gd php8.3-mbstring php8.3-xml php8.3-curl - 装完检查
php --ini输出里的 “Scan for additional .ini files in”，比如/etc/php/8.3/cli/conf.d/，看有没有20-zip.ini这类文件生成 - 如果没有，手动创建
/etc/php/8.3/cli/conf.d/20-zip.ini，内容只有一行：extension=zip
macOS 上 brew reinstall php 后 ext-fileinfo 仍不显示
Homebrew 的 PHP 编译默认不启用所有扩展，尤其是 fileinfo —— ThinkPHP 8.0 启动时硬性依赖它，缺了直接 autoload 失败。
brew install php 不等于开箱即用，必须重编译并显式启用：
- 运行
brew reinstall php --with-fileinfo --with-mbstring --with-openssl（其他扩展按需加） - 过程耗时 3～8 分钟，别中断；完成后执行
brew link php确保符号链接生效 - 验证：
php -m | grep -E "fileinfo|mbstring|openssl"必须全部出现 - 如果
which php指向/usr/bin/php，说明 PATH 没切到 Homebrew 版本，要检查 shell 配置（~/.zshrc或~/.bash_profile）里是否漏了export PATH="/opt/homebrew/bin:$PATH"
Docker 或宝塔面板里扩展“已安装但不生效”
装了 ≠ 启用了。Docker 镜像常精简掉扩展，宝塔软件商店点安装后也可能卡在配置层。
关键检查点只有三个，缺一不可：
- CLI 和 Web（FPM）用的是两套 php.ini：用
php --ini查 CLI 的，用phpinfo()页面查 Web 的 “Loaded Configuration File” - 扩展文件物理路径是否正确：
php -i | grep extension_dir输出的路径下，必须存在对应.so文件（如redis.so），且权限为 644、所有者为 www:www（宝塔）或 www-data:www-data（Ubuntu） - php-fpm 进程必须重启：宝塔点“重启PHP”，Docker 要
docker restart或重建容器，仅 reload 配置无效
最常被忽略的是 extension_dir 路径拼错，或者扩展文件名和 php.ini 里写的不一致——比如写了 extension=redis.so，但实际文件叫 redis-5.3.7.so。
