本页面说明如何解决 配置 > 系统健康状态(WHMCS 7.10 及更早版本路径:帮助 > 系统健康状态)中部分常见警告。
定时任务PHP版本不匹配
许多服务器配置会在命令行或定时任务引擎中使用独立的 php.ini
文件,与Web服务器使用的配置不同。这可能导致自动化任务运行时的PHP版本与通过浏览器访问管理区域时的PHP版本不一致。
此警告用于识别自动化任务是否在与浏览器访问管理区域不同的PHP版本下执行。
请参考以下指南(适用于原生cPanel服务器)逐步解决问题:
识别命令行/定时任务引擎使用的php.ini文件
若无法自行解决,请联系您的服务器管理员/托管提供商协助。
当每日自动化任务下次执行时(配置路径:配置 > 系统设置 > 自动化设置 > 每日执行时间,或WHMCS 7.10及更早版本的 设置 > 自动化设置 > 每日执行时间),若PHP版本已统一,此警告将消失。
定时任务PHP时区设置
许多服务器配置会在命令行或定时任务引擎中使用独立的 php.ini
文件,与Web服务器使用的配置不同。这可能导致自动化任务运行时的时区与通过浏览器访问管理区域时的时区不一致。
此警告用于识别自动化任务是否在与浏览器访问管理区域不同的时区下执行。
请参考以下指南(适用于原生cPanel服务器)逐步解决问题:
识别命令行/定时任务引擎使用的时区
若无法自行解决,请联系您的服务器管理员/托管提供商协助。
当时区已统一时,当每日自动化任务下次执行时(配置路径同上),此警告将消失。
网站SSL证书
WHMCS未配置以 https://
协议开头的系统URL。
安装网站证书后,请按以下步骤启用:
-
导航至 配置 > 系统设置 > 常规设置。
-
在“常规”标签页中找到“系统URL”设置。
-
修改值,使其以
https://
开头(例如:https://example.com/whmcs/
)。 -
点击 保存更改。
服务器未检测到CA验证的SSL证书
WHMCS会通过cURL调用系统URL验证SSL证书有效性:
若返回的状态码非200,系统健康状态页面将显示此错误。
请联系您的服务器管理员/托管提供商,确保返回200状态码。
cURL/TLS/OpenSSL版本警告
截至本文撰写时,系统健康状态页面检查以下最低版本:
-
cURL: 7.36.0
-
TLS: 1.1 和 1.2
-
OpenSSL: 1.0.1c
建议使用环境支持的最新版本。若需更新,请联系您的服务器管理员/托管提供商协助。
PHP版本
尽可能使用处于活跃开发阶段的PHP版本。
请参考系统环境指南,确定与您WHMCS软件版本兼容的最新PHP版本。升级PHP版本可能需要联系您的托管提供商协助。
PHP 8.1 支持说明
-
WHMCS 8.0 至 8.5 推荐使用 PHP 7.4(PHP 7.4的安全支持截止至2022年11月28日)。
-
WHMCS 8.6 及更高版本支持 PHP 8.1,推荐使用。
-
由于ionCube Loader不支持 PHP 8.0,WHMCS暂不计划支持 PHP 8.0。
推荐的PHP扩展
WHMCS需要多个PHP扩展才能完全运行。若检测到缺失推荐扩展,将在此列出。
建议重新编译PHP并添加缺失的扩展。若需修改,请联系您的服务器管理员/托管提供商协助。
自动更新要求
WHMCS自动更新工具可通过几步操作应用新软件更新。此测试确保您的系统满足使用自动更新工具的要求。
请导航至 实用工具 > 更新WHMCS,点击“配置更新设置”以指定更新过程中临时文件的存储目录(需可写)。更多信息请参考自动更新文档。
自定义模板
此检查用于识别是否使用了系统默认主题或订单表单模板名称。若未对默认模板进行自定义,此警告可忽略。
若已对系统主题或订单表单模板进行自定义,建议先复制默认模板,再对副本进行修改。这样更新时自定义内容不会丢失。更多信息请参考模板自定义文档。
-
选择系统主题:在 配置 > 系统设置 > 常规设置 的“常规”标签页中,使用“系统主题”设置(WHMCS 7.10及更早版本路径:设置 > 常规设置)。
-
选择默认订单表单模板:在 配置 > 系统设置 > 常规设置 的“订单”标签页中,使用“订单表单模板”设置(WHMCS 7.10及更早版本路径:设置 > 常规设置)。
CloudLinux MySQL扩展检查
此检查针对CloudLinux™用户,若当前使用 pdo_mysql
PHP扩展,可能导致WHMCS界面显示问题或其他异常。
解决方法:使用CloudLinux PHP选择器启用 nd_pdo_mysql
扩展:
-
登录服务器,访问CloudLinux PHP配置界面。
-
取消勾选
pdo_mysql
选项。 -
勾选
nd_pdo_mysql
选项并启用。
修改后,刷新系统健康状态页面即可生效。若需帮助,请参考CloudLinux PHP选择器文档或联系服务器管理员。
对于其他服务器环境,请联系服务器管理员/托管提供商重新编译PHP以启用原生驱动。
MySQL服务器配置检查
WHMCS需要连接MySQL数据库以完全运行,且在处理高负载任务时需保持连接。此测试确保系统满足最低配置要求,避免数据库操作异常。
建议调整MySQL服务器配置文件(my.cnf
)中测试标记为过低的参数值。
如何编辑MySQL/MariaDB配置文件(my.cnf
):
来源:cPanel
若需修改,请联系您的服务器管理员/托管提供商协助。
支持票证掩码检查
每个支持票证会被分配唯一参考编号。若编号规则自定义不当,可能限制可用编号组合的数量。此测试将根据“支持票证掩码格式”设置,估算可能的票证编号组合总数。
-
当已使用51%-85%的可能组合时,显示警告。
-
当已使用85%或更多可能组合时,显示“需要注意”项。
建议调整“支持票证掩码格式”以增加可能的编号组合数量(例如添加额外数字掩码 %n
)。