ionCube 错误排查​ 列印

为保护 WHMCS 软件代码安全，我们使用 ionCube® 系统进行混淆加密。ionCube 加载器配置不当可能导致以下错误：

​​错误：需安装 ionCube PHP 加载器​​

您可能遇到类似以下错误：

站点错误：需安装 ionCube PHP 加载器。这是运行 ionCube 加密 PHP 代码、保障网站安全和拦截恶意软件的必备扩展。请访问 get-loader.ioncube.com 获取安装帮助。

​​原因​​

此错误表明服务器上的 ionCube 加载器配置存在问题（版本过旧或未安装）。

​​解决方案​​

1. 联系​​托管服务商​​确认安装合规版本（详见系统要求）

2. 通过 SSH 以运行 cron 任务的用户身份登录服务器

3. 执行命令：

*若服务器有多个 PHP 版本，替换为 WHMCS 使用的具体路径：

1. 检查输出：

    
   
   • •

     无 ionCube PHP Loader→ 未安装

   • •

     版本号过旧 → 不符合要求

   ⚠️ WHMCS ​​不支持 PHP 8.0​​，需切换至 PHP 7.4 或 8.1

2. 要求服务商确保安装合规版本并对 cron 用户生效

​​文件无法解码错误​​

示例报错：

文件 /home/user/public_html/whmcs/modules/gateways/paypalexpress.php (编码类型 [1/71]) 无法被当前 ionCube 加载器版本解码

​​解决方案​​

1. 通过 FTP 访问报错文件路径（如 /public_html/whmcs/modules/gateways/)
   

2. 删除指定文件（如 paypalexpress.php)

3. 在 WHMCS 重新加载页面

4. 重复处理其他报错文件直至页面正常

更多信息请参见 PHP 迁移指南

​​cron.php 加载器错误​​

​​解决方案​​

1. 按前述步骤验证 ionCube 状态

2. cron 命令需指定 PHP 路径：