赞片CMSimagick

照着做完，你能让赞片CMS所在的服务器正确装上并启用 Imagick 扩展，后台生成缩略图、水印不再报 "Class 'Imagick' not found"。

第一步：确认服务器到底缺不缺 Imagick

这一步的目标是搞清楚"是没装 ImageMagick 本体，还是 PHP 没加载扩展"，避免上来就乱装。

SSH 登录服务器，依次执行：

php -v                      # 先记住 PHP 版本，比如 8.1.27
php -m | grep -i imagick    # 没有任何输出就说明扩展没加载
convert -version            # 报 command not found 说明 ImageMagick 本体也没装

注意：如果服务器上跑的是宝塔、aaPanel 这类面板，php -v 看到的可能是系统自带 PHP，不是网站实际用的那一个。面板环境下以「网站 → 站点 → 对应 PHP 版本」为准。

第二步：安装 ImageMagick 本体和 PHP 扩展

这一步做完，系统里就有了 ImageMagick 程序，PHP 也有了 imagick.so 扩展文件。

Ubuntu / Debian（推荐用 apt 直接装对应版本）：

apt update
apt install imagemagick libmagickwand-dev -y
apt install php8.1-imagick -y     # 把 8.1 换成第一步查到的版本号

CentOS / AlmaLinux / Rocky：

yum install ImageMagick ImageMagick-devel gcc make -y
pecl install imagick-3.7.0        # 回车一路默认即可

宝塔面板用户（最省事）： 打开面板 → 左侧「软件商店」→ 找到站点正在用的 PHP 版本（如 PHP-8.1）→ 点右侧「设置」→ 顶部「安装扩展」→ 在列表里找到 imagick → 点「安装」，等进度条跑完。

注意：PHP 8.0 以上请用 Imagick 3.7.x，PHP 7.2 以下只能停在 Imagick 3.4.x，装错版本会编译失败或加载崩溃。

第三步：让 PHP 真正加载 imagick 扩展

安装完不等于启用，这一步是把扩展写进 php.ini 并重启 PHP 进程。

编辑站点实际使用的 php.ini（位置可以用 php --ini 查，宝塔一般在 /www/server/php/81/etc/php.ini），在文件末尾加一行：

extension=imagick.so

Windows 环境则是 extension=php_imagick.dll，并把 php_imagick.dll 放进 PHP 的 ext 目录。

保存后重启 PHP：

systemctl restart php-fpm        # 或 systemctl restart php8.1-fpm

宝塔面板则在 PHP 设置页点「服务」→「重启」。

注意：只重启 Nginx 或 Apache 是没用的，PHP-FPM 不重启，php.ini 的改动不生效。

第四步：验证扩展是否真的生效

这一步是验收，确认 imagick 已挂上，不是"看起来装了"。

新建一个 info.php，内容写 <?php phpinfo(); ?>，放到网站根目录，浏览器访问 你的域名/info.php，搜索 imagick，能看到版本号和 ImageMagick version 就成功了。命令行方式：

php -r "var_dump(extension_loaded('imagick'));"   # 输出 bool(true)
php -r "print_r(Imagick::queryFormats('JPEG'));"  # 能列出 JPEG 格式即可

验证完记得删掉 info.php。

第五步：在赞片CMS后台切换图片处理引擎

扩展装好了，最后一步是让 CMS 用它。登录赞片CMS后台 → 「系统」→「系统设置」→ 找到「图片处理 / 附件设置」一栏（部分版本叫「性能优化」），把图片处理库从 GD 改成 Imagick，保存。然后进「系统」→「缓存管理」→ 清除全部缓存。

改完后随便打开一个视频详情页，看缩略图是否能正常生成；或后台上传一张大图，观察是否报错。

注意：Imagick 默认内存占用比 GD 高，如果生成大图时报内存错误，把 php.ini 里的 memory_limit 从 128M 提到 256M 或 512M。

第六步：几个常见报错怎么处理

• Class 'Imagick' not found：扩展没加载，回第三步检查 extension=imagick.so 是否写对、PHP 是否重启。
• no decode delegate for this image format（PDF/PSD 打不开）：ImageMagick 的 policy.xml 默认禁用了这些格式，编辑 /etc/ImageMagick-6/policy.xml 或 /etc/ImageMagick-7/policy.xml，把对应 rights="none" 改成 rights="read|write"。
• 缩略图模糊：后台「图片处理」里的缩略图质量参数调高到 90 左右。

小结

• 先确认 php -m 和 convert -version，分清是缺本体还是缺扩展。
• 扩展版本要匹配 PHP 版本：PHP 8.x 用 Imagick 3.7.x。
• php.ini 写完必须重启 PHP-FPM，重启 Web 服务器无效。
• 用 phpinfo() 或 extension_loaded('imagick') 验证，别凭感觉。
• 后台把图片处理库切到 Imagick 并清缓存，才算真正用上。
• 大图报内存错就调 memory_limit，格式不支持就改 policy.xml。