宝塔面板安装ImageMagick教程

当您的宝塔面板中PHP应用（如WordPress插件、图床或CMS缩略图功能）报出“ImageMagick module not available”错误时，说明系统缺少ImageMagick核心库或PHP Imagick扩展未正确安装；本文手把手详解四种实用解决方案——从宝塔软件商店一键启用扩展，到Linux下手动编译安装以支持WEBP等高级格式，再到修复Ubuntu/Debian因缺失/etc/redhat-release导致的编译中断问题，最后覆盖Windows环境下的ImageMagick与php_imagick.dll配置全流程，助您快速打通图像处理依赖，让网站图片功能稳定高效运行。

当您在宝塔面板中运行依赖ImageMagick的PHP应用（如WordPress插件、图床或CMS图像缩略图生成）时，若出现“ImageMagick module not available with this PHP installation”错误，说明系统未安装ImageMagick核心程序或PHP Imagick扩展未启用。以下是针对不同场景的安装方法：

一、通过宝塔软件商店一键安装Imagick扩展

该方法适用于CentOS/Ubuntu系统且ImageMagick系统级组件已预装或可自动补全依赖的环境。宝塔会尝试调用系统包管理器安装基础库，并启用PHP扩展。

1、登录宝塔面板，在左侧菜单点击软件商店。

2、在搜索框输入当前使用的PHP版本号（例如PHP 7.4、8.0），找到对应条目后点击右侧设置按钮。

3、在PHP设置页面中，切换至扩展标签页。

4、在扩展搜索框中输入imagick，找到列表中的Imagick扩展并点击安装。

5、安装完成后，返回宝塔首页，点击左侧服务 → 重启PHP（选择对应版本）。

二、手动编译安装ImageMagick系统库 + Imagick PHP扩展

该方法适用于宝塔一键安装失败、提示“/etc/redhat-release: No such file or directory”、或需启用WEBP等高级图像格式支持的场景。需分步安装底层ImageMagick程序与PHP绑定扩展。

1、使用SSH登录服务器，执行以下命令下载并安装ImageMagick系统库：

2、wget https://www.imagemagick.org/download/ImageMagick.tar.gz

3、tar -zxvf ImageMagick.tar.gz && cd ImageMagick-*

4、./configure --prefix=/usr/local/imagemagick --enable-shared --with-modules

5、make && sudo make install

6、将ImageMagick二进制路径加入系统环境变量：echo 'export PATH="/usr/local/imagemagick/bin:$PATH"' >> /etc/profile && source /etc/profile

7、验证安装：convert -version 应输出版本信息。

8、下载并编译Imagick PHP扩展源码包（以PHP 8.0为例）：

9、cd ~ && wget https://pecl.php.net/get/imagick-3.7.0.tgz

10、tar -zxvf imagick-3.7.0.tgz && cd imagick-3.7.0

11、/www/server/php/80/bin/phpize

12、./configure --with-php-config=/www/server/php/80/bin/php-config --with-imagick=/usr/local/imagemagick

13、make && sudo make install

14、编辑PHP配置文件：/www/server/php/80/etc/php.ini，在末尾添加：

15、extension = imagick.so

16、重启PHP服务：bt restart php80 或通过宝塔界面操作。

三、修复/etc/redhat-release缺失导致的编译失败

该问题常见于Ubuntu/Debian系统运行宝塔时，因Imagick构建脚本硬性检测Red Hat发行版标识文件而中断。需创建兼容性占位文件以绕过检测逻辑。

1、执行命令创建空文件：sudo touch /etc/redhat-release

2、向该文件写入标准CentOS标识内容（以CentOS 7为例）：echo "CentOS Linux release 7.9.2009 (Core)" | sudo tee /etc/redhat-release

3、确认文件已存在且内容正确：cat /etc/redhat-release

4、重新进入宝塔面板执行Imagick扩展安装，或继续执行手动编译流程。

四、Windows系统下为宝塔（或本地WAMP/XAMPP）配置Imagick

该方法适用于开发测试环境或Windows版宝塔（较少见），需分别安装ImageMagick程序与PHP扩展DLL文件。

1、访问https://imagemagick.org/download/binaries/，下载最新版ImageMagick-*-Q16-x64-dll.exe安装包。

2、双击运行安装程序，勾选Add application directory to your system path选项。

3、安装完成后，打开CMD窗口执行：magick -version，确认输出版本号。

4、前往https://windows.php.net/downloads/pecl/releases/imagick/，下载匹配PHP版本及线程安全（TS/NTS）、架构（x64）的php_imagick.dll文件。

5、将下载的DLL复制到PHP扩展目录（如：C:\php\ext\）。

6、编辑php.ini，在[PHP]段落下方添加：extension=php_imagick.dll

7、重启Web服务（如Apache或Nginx）及PHP-FPM进程。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。