一、故障现象:动态页全挂,静态页没事
网站全线异常。症状非常有规律:首页及所有动态页面一律返回 HTTP 500;但 png 图片、robots.txt 这类静态文件始终 200 正常。响应头里能看到 x-powered-by: PHP/7.4.33、content-type: text/html;charset=UTF-8,但 body 是空的。刷新任意动态页必然复现,不是偶发。
访问日志给出了精确的突变时间:19:52:18 最后一条正常请求(/news/list-9.html 返回 200),19:54:01 起动态页全部 500,而静态文件在 20:06、20:08 仍是 200。
这几条证据组合在一起,很快就能把范围从"整个站点"缩小到"PHP 执行层":Web 服务器正常、磁盘正常、网络正常,问题出在 PHP 启动或加载环节。
二、排查过程:一层一层排除
第一步,看访问日志
访问日志确认了故障起止时间与影响面:静态资源全程 200,说明 Apache 与磁盘没有问题,故障在 PHP 执行层。顺带还发现 11 月 2 日曾有一次 503 集中爆发,与本次无关,属于历史噪音。
第二步,看 Apache 错误日志
第二份日志是 Apache 错误日志,共 299 行。其中 259 行是 AH01276(找不到匹配的 DirectoryIndex),还剩少量 .htaccess 拒绝记录和凌晨的扫描噪音。关键负向证据是:整份日志里没有任何 PHP Fatal、没有 MySQL/SQL 错误。 这意味着错误发生在 PHP 内部更深层,或者被吞掉了,Apache 根本没有机会记录。
第三步,检查环境与文件
确认了以下事实:
index.php 存在,权限 644,正常;
切换 PHP 版本无效——但当时是在 7.x 之间切换,方向其实不对;
数据库存在,phpMyAdmin 可以打开,表都在。
第四步,用测试文件逐层定位
这一轮起了决定性作用。我们按"环境 → 连接 → 入口"做了五个测试:
第一个,test.php:开启 display_errors 后 require index.php,结果空白。原因是 Destoon 入口会自行重置错误级别,外层 ini 设置无效,这个结果当时不构成结论。
第二个,t1.php:直接输出 echo PHPOK-'.PHP_VERSION,得到 PHPOK-7.4.33。证明 PHP 环境本身完全正常。
第三个,t2.php:include config 后用 mysqli 连接,报 Access Denied。这一步一度把排查带偏了——后来才明白,它报的其实不是数据库认证失败,而是没定义 IN_DESTOON 常量被 Destoon 入口保护拦下了。
第四个,t4.php:定义 IN_DESTOON 常量、用 $CFG 数组原始方式连接数据库,得到 CONN_OK。证明 config 里的数据库主机、用户名、库名、密码全部正确,MySQL 连接没问题。
第五个,t5.php:用 register_shutdown_function + error_get_last() 兜底捕获致命错误,再 require index.php,终于抓到了真凶:<>。根因定位完成。
三、根因分析:PHP 版本演进撞上老去的 CMS
3.1 直接根因
t5.php 捕获到的致命错误非常明确:
plaintext
123
FATAL: Uncaught Error: Call to undefined function mysql_connect()
in /home2/destoon/include/db_mysql.class.php:20
调用链是这样的:index.php 引入 common.inc.php,common.inc.php 实例化 db_mysql 数据库类并调用 connect 方法,而 include/db_mysql.class.php 的第 20 行直接调用了 mysql_connect()——这个函数在 PHP 7.4 里根本不存在。
3.2 为什么 PHP 7.4 里没有 mysql_connect
PHP 官方对旧版 MySQL 扩展(mysql_* 函数)的处置有一个明确的时间线:
PHP 5.5 起,mysql 扩展被标记为废弃(deprecated),但仍然可用;PHP 5.6 仍可用,只是每次调用会产生弃用告警;PHP 7.0 起正式移除,mysql_connect() 彻底消失;PHP 7.4 及 8.x 只保留 mysqli_* 与 PDO_MySQL 两套接口。
Destoon 9.0 的 db_mysql.class.php 还停留在调用 mysql_connect() 的年代。于是在 PHP 7.0 及以上版本,加载数据库类的一瞬间就会抛出 Error: Call to undefined function mysql_connect();Destoon 对致命错误没有兜底捕获,加上生产环境 display_errors=Off,最后用户看到的就是一个空 body 的 HTTP 500——非常具有迷惑性。
3.3 为什么"切换 PHP 版本"无效
故障期间尝试在 7.0/7.1/7.2/7.3/7.4 之间切换,结果全都不行。原因很简单:所有 7.x 都没有 mysql 扩展,在这个区间内切换没有任何意义。站点此前长期正常,说明它当时实际运行在 PHP 5.6(最后一个带 mysql 扩展的受支持版本)。某次 PHP 版本调整或升级到 7.4 后,兼容性问题立刻暴露。
3.4 一个重要的排查陷阱
config.inc.php 采用的是 $CFG 数组形式配置数据库:
php
12345
$CFG['db_host'] = 'localhost';
$CFG['db_name'] = '********';
$CFG['db_user'] = '********';
$CFG['db_pass'] = '...';
早期 t2.php 直接 include config.inc.php 却报 Access Denied,实际是两个原因的叠加:其一,config.inc.php 第 6 行有入口保护 defined('IN_DESTOON') or exit('Access Denied'),没定义这个常量就被拦住了;其二,用独立变量 $db_host/$db_user 去读,而配置文件实际存的是 $CFG['db_host'] 数组形式。
这给所有排查者一个教训:测试脚本必须以 CMS 真实读取的方式进行(定义入口常量 + 用原始变量/数组),否则得到的错误是伪错误,会把人带偏好几个来回。
四、最终解决方案
方案 A(推荐,改动最小):切换 Destoon 数据库驱动为 mysqli
Destoon 通常自带 mysqli 驱动文件 include/db_mysqli.class.php,与 db_mysql.class.php 并列存在。只需要改配置文件一行,把数据库驱动从 mysql 切到 mysqli:
第一步,确认驱动文件存在:
bash
12
ls -la /home2/destoon/include/db_*.class.php
期望同时看到 db_mysql.class.php 和 db_mysqli.class.php。
第二步,修改 config.inc.php 第 7 行:
php
12345
// 原值
$CFG['database'] = 'mysql';
// 改为
$CFG['database'] = 'mysqli';
第三步,保存后刷新主站,验证首页与各模块返回 200。
原理很简单:mysqli 是 mysql 的官方替代扩展,面向对象、安全性更强,Destoon 已经内置了对应的驱动封装。切换后 SQL 行为保持一致,不需要改动任何业务代码,这是成本最低的修复方式。
方案 B(兜底):将 PHP 版本回退到 5.6
如果服务器上没有 db_mysqli.class.php,或者切换后还有其他 PHP 7 兼容问题,可以走兜底方案:在 cPanel 的 MultiPHP Manager 中选择 PHP 5.6(最后一个支持 mysql 扩展的版本),然后刷新验证。
需要提醒的是,PHP 5.6 早已停止安全维护,这个方案只适合短期恢复,不建议长期停留在 5.6 上。
方案 C(长期):全面迁移到 PHP 7.4+ × mysqli/PDO
长期来看,推荐以方案 A 为基础完成升级,并做一次系统性的清理:
全局排查 mysql_* 残留函数:mysql_connect、mysql_query、mysql_fetch_*、mysql_error、mysql_num_rows 等,全部替换为 mysqli 对应函数;
排查其他 PHP 7 不兼容点:mysql_real_escape_string()、each()、create_function()、mcrypt 扩展等;
升级到支持 PHP 8 的较新 Destoon 版本(V9.0 官方最低兼容 5.3,社区方案覆盖 5.6–8.2)。
五、验证与收尾清单
恢复之后,还有几件事需要收尾:
第一,验证恢复。主站首页 200,抽查 /news、/job、/company、/show-xxx 等动态页全部 200,静态资源不受影响。
第二,清理测试文件。删除 根目录下的 test.php、t1.php、t2.php、t3.php、t4.php、t5.php,一个都不能留。
第三,清空 Destoon 缓存。删除或清空 cache 目录(file 缓存模式),避免模板和数据缓存残留旧状态。
第四,备份配置。修改前生成的 config.inc.php.bak 先保留,确认线上无问题后再删。
第五,复查历史噪音。Apache 错误日志里的 AH01276(目录索引缺失)需要确认根目录 public_html 是否缺少独立入口文件,避免殃及其他 URL。
六、经验总结
这次排查最有价值的部分,是把一类非常经典的 CMS 兼容性问题完整走了一遍,其中有几条经验对同类站点普遍适用:
其一,PHP 版本是 CMS 兼容性的第一检查点。老程序(2010 年前后)如果依赖 mysql_* 扩展,凡是跑在 PHP 7.0+ 上都会触发 Call to undefined function mysql_connect()。它的典型症状非常有迷惑性:动态页全 500、静态页正常。
其二,遇到空 body 的 500,第一件事就是想办法把 PHP 错误挖出来。先开 display_errors,再逐层 require 入口文件;如果 CMS 覆盖了错误级别,就用 register_shutdown_function + error_get_last() 兜底捕获 fatal。
其三,测试脚本一定要模拟真实加载路径。按 CMS 的入口约定(如 IN_DESTOON 常量、$CFG 数组)来复现连接,否则会被入口保护之类的机制误导。
其四,版本切换方向要对。要切到目标兼容版本(5.6),而不是在 7.x 系列内部反复切换,那是无效劳动。
其五,记住正确的修复顺序:先验证 PHP 环境,再验证数据库连接,然后抓真实 fatal,最后修驱动或版本、清缓存、删测试文件。一步一个脚印,问题早晚会暴露。














渝公网安备50010502504815号