宝塔面板中PHP应用报“ImageMagick module not available”错误，需安装ImageMagick系统库及PHP Imagick扩展：一、宝塔软件商店一键安装；二、手动编译安装ImageMagick和Imagick；三、修复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进程。
