phpEnv默认不集成gmagick扩展，需手动下载匹配NTS版本的php_gmagick.dll、安装GraphicsMagick并配置MAGICK_HOME环境变量，否则getSupportedFormats()返回空数组。
phpEnv里找不到gmagick扩展选项怎么办
phpEnv默认不集成gmagick，因为它是第三方C扩展，需手动编译或替换DLL。它不像imagick那样被主流一键环境收录，所以你在phpEnv面板的“PHP扩展”列表里搜不到它——这不是配置遗漏，是压根没打包进去。
解决路径只有一条：确认你的phpEnv底层PHP是NTS（非线程安全）版（绝大多数phpEnv默认如此），然后去PECL官网下载对应PHP版本的gmagick预编译DLL（如php_gmagick.dll），别下错TS/NTS或位数。
- 先用
phpinfo()确认：PHP Extension Build字段含NTS、Architecture是x64还是x86 - Windows下
gmagick依赖GraphicsMagick本体，必须先装好它（推荐GitHub官方发行版），并把bin目录加进系统PATH - 下载的
php_gmagick.dll放进phpEnv的ext目录（通常是D:\phpEnv\php\ext这类路径）
php.ini里启用gmagick后仍报“Class not found”
常见原因是GraphicsMagick运行时库没加载成功，或者DLL版本与PHP不兼容。即使extension=php_gmagick.dll已写入php.ini，php --ri gmagick命令返回空或报错，基本可锁定为依赖缺失。
关键检查点：
立即学习“PHP免费学习笔记（深入）”；
- 打开CMD，执行
gmx -version（不是gm或convert），能输出版本号才说明GraphicsMagick安装且PATH生效 - 把GraphicsMagick安装目录下的
bin里所有.dll（尤其是CORE_RL_*.dll和gminstall.dll）复制到phpEnv的PHP根目录（即放php.exe的那个文件夹） - phpEnv通常用多个PHP版本共存，务必确认你改的是当前启用版本的
php.ini——不是主目录下的，而是D:\phpEnv\php\php-8.1-nts\php.ini这种带版本号的路径 - 重启phpEnv控制面板里的Web服务（Apache/Nginx）和PHP-FPM，仅重启浏览器或刷新
phpinfo()页面无效
为什么选gmagick而不是imagick？性能差异在哪
在phpEnv这种轻量级本地开发环境里，gmagick的优势很实在：内存占用更低、初始化更快、处理同一张大图（比如5000×3000 JPEG）平均快15%~25%，尤其适合批量缩略图生成或CI流程中的图片校验。
但代价是功能少——不支持PSD、PDF等复杂格式解析，滤镜种类也比imagick少约1/3。如果你只是做水印、裁剪、格式转换，gmagick更干净；如果要读取分层PSD或做CMYK色彩管理，还是得切回imagick。
- 代码层面几乎一致：
$gm = new Gmagick('input.jpg'); $gm->resizeImage(200, 150, ...); - 注意命名空间：
gmagick类名全小写（Gmagick、GmagickPixel），而imagick是首字母大写（Imagick） - phpEnv下
gmagick对OPcache更友好，多次调用new Gmagick()不会像早期imagick那样触发频繁的资源释放抖动
phpEnv启用gmagick后getSupportedFormats()返回空数组
这是最隐蔽也最常被忽略的问题：GraphicsMagick的coders模块没被正确识别。即使gmx -version成功，gmagick扩展仍可能报告Number of supported formats: 0。
根本原因在于phpEnv没有自动设置MAGICK_HOME环境变量。你必须手动添加：
- 在Windows系统属性 → 环境变量 → 系统变量中新建：
MAGICK_HOME，值设为GraphicsMagick安装路径（如C:\Program Files\GraphicsMagick-1.3.42-Q16） - 确保该路径下存在
modules\coders子目录，里面有一堆*.dll（如jpeg.dll、png.dll） - 改完环境变量后，**必须重启phpEnv主进程**（关闭托盘图标再重开），仅重启Apache或PHP-FPM不够
- 验证方式：
php -r "echo (new Gmagick())->getSupportedFormats() ? 'OK' : 'FAIL';"
这个MAGICK_HOME变量不设，gmagick就找不到解码器，哪怕所有DLL都放对位置，也会静默失效——这点比imagick严格得多，也是最容易卡住人的地方。
