如何让PHP强制使用新版ImageMagick？

安全阿岳

2026-6-23

解决PHP Imagick扩展绑定旧版ImageMagick的问题

核心原因

PHP的Imagick扩展是编译时绑定ImageMagick库的，因此即使系统层面已安装新版ImageMagick，旧的Imagick扩展仍会调用编译时关联的旧库，必须重新编译扩展绑定新版库才能解决。

cPanel使用EA-PHP管理PHP版本，需使用其专属工具处理：

安装对应PHP版本的开发依赖
cPanel的PHP开发包以ea-php<版本号>-devel命名，以PHP 8.1为例：
```
sudo yum install ea-php81-devel ea-php81-pear
```
这会安装phpize、php-config等编译所需工具。
卸载旧的Imagick扩展
通过cPanel命令行工具卸载对应PHP版本的扩展：
```
sudo /usr/local/cpanel/bin/ea-php81 pecl uninstall imagick
```
也可通过WHM面板的「EasyApache 4」界面，找到PHP 8.1对应的Imagick扩展进行卸载。
确保系统识别新版ImageMagick
先确认系统能正确检测到ImageMagick 7：
```
pkg-config --modversion ImageMagick
```
若返回7.1.1则正常；若返回旧版本，需指定新版ImageMagick的pkg-config路径（假设IM7安装在/usr/local）：
```
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
```
重新编译并安装Imagick扩展
使用对应PHP版本的pecl工具安装：
```
sudo /usr/local/cpanel/bin/ea-php81 pecl install imagick
```
安装过程中若提示路径配置，直接回车使用默认即可。
重启服务生效
```
sudo systemctl restart ea-php81-php-fpm httpd
```
之后通过print_r(imagick::getVersion())验证版本是否更新。

若需回退到该环境，按以下步骤操作：

卸载旧Imagick扩展
先查找已安装的扩展包：
```
yum list installed | grep php-imagick
```
卸载对应包（以remi源的PHP7.4为例）：
```
yum remove php74-php-imagick
```
安装PHP开发依赖
确保remi源已启用，安装所需工具：
```
yum install php74-php-devel php74-php-pear
```
配置ImageMagick 7环境
同样确认pkg-config路径，若IM7为编译安装，需先执行ldconfig更新系统库缓存：
```
ldconfig
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
```
编译安装Imagick扩展
由于CentOS 7的PHP7.4在SCL环境中，需启用环境后执行安装：
```
scl enable php74 'pecl install imagick'
```
启用扩展并重启服务
在PHP配置目录添加扩展配置（如/etc/opt/remi/php74/php.d/20-imagick.ini）：
```
extension=imagick.so
```
重启服务：
```
systemctl restart php74-php-fpm httpd
```

编译安装ImageMagick 7时，需添加--enable-shared参数生成动态库，否则PHP扩展无法调用。
若手动编译IM7，完成安装后务必执行ldconfig，确保系统库缓存更新。
检查phpinfo()的Imagick模块信息，重点确认ImageMagick version和ImageMagick library path是否指向新版库。

内容的提问来源于stack exchange，提问作者Jason Comparetto