WP Panel PHP 扩展安装指南：默认扩展、面板安装与手动安装

先判断：你需要的是“安装扩展”还是“加载 Loader”

WordPress 插件或主题提示缺少 PHP 功能时，通常有两种情况：一是缺少 Debian/PHP 软件包，例如 Imagick、SOAP 或 BCMath；二是商业主题、插件或加密组件提供了自己的 .so Loader，需要在 PHP-FPM 配置中加载。两者都不是修改 WordPress 数据库设置能够解决的问题。

WP Panel 默认安装的 PHP 8.3 组件

WP Panel 官方安装脚本默认安装以下常用 PHP 8.3 扩展：

mysql、curl、gd、exif
mbstring、xml、zip、intl
redis、opcache

同时安装的 php8.3-fpm 和 php8.3-cli 是运行组件。默认环境足够运行大多数博客、企业站和常见 WordPress 插件，但不会为了少数场景预装所有 PHP 扩展。

v1.10.0 中可以从面板安装的扩展

imagick：高级图片处理，常见于商业主题、图片优化和媒体处理插件。
soap：支付、物流和第三方 SOAP 服务接口。
bcmath：高精度金额计算和支付、电商插件。
gmp：部分加密和数学计算组件。
memcached：Memcached 对象缓存客户端。

打开“软件管理 → PHP 扩展”即可查看当前 PHP-FPM 已加载的完整列表，以及上述五个扩展的软件包状态。面板只提供安装，不提供删除；扩展是服务器级共享能力，删除前需要评估其他网站和系统依赖。

面板不支持的扩展，如何自行安装？

如果扩展不在面板的五项安装清单内，首先确认它是否有适用于 PHP 8.3 和 Debian 13 的可信软件包。使用 root 或 sudo 管理员通过 SSH 安装，示例：

sudo apt update
sudo apt install -y php8.3-xxx
sudo systemctl reload php8.3-fpm
php-fpm8.3 -m

把 xxx 替换为实际扩展名。软件包名称不是固定规则，安装前应以扩展官方文档和当前软件源为准。PECL、源码编译扩展、ionCube、SourceGuardian 以及主题自带 Loader，不能直接套用上面的命令。

第三方 Loader 的配置

如果官方文档要求使用 extension=/path/to/module.so 或 zend_extension=/path/to/loader.so，可以打开“软件管理 → PHP”中的自定义配置区域填写。该配置作用于 PHP-FPM，不会自动同步到 CLI。

如果 .so 位于网站 WebRoot 或网站用户可写的目录，面板保存时会显示高风险提示，必须由管理员明确确认。不要从不明来源下载 Loader，也不要把“语法检查通过”理解为第三方扩展已经安全或每条参数都有效。

安装后的检查

在“软件管理 → PHP 扩展”查看 PHP-FPM 已加载扩展。
如果扩展已经安装但没有加载，检查 PHP 8.3-FPM 的配置和错误日志。
确认主题或插件的要求与当前 PHP 8.3 版本匹配，再清理 WordPress、Redis 或 OPcache 缓存。
涉及 PHP-FPM reload 时，建议在低峰期操作，因为它是服务器级服务，可能短暂影响全部网站。

如果你只需要安装 Imagick、SOAP、BCMath、GMP 或 Memcached，优先使用面板入口；如果是其他扩展或商业 Loader，再按供应商文档手动处理，并保留可恢复的配置。