PHP 版本迁移导致 Destoon 全线 500:一次完整的故障排查与修复

   2026-11-21 重庆资讯网巨浪420
核心提示:一、故障现象:动态页全挂,静态页没事网站全线异常。症状非常有规律:首页及所有动态页面一律返回 HTTP 500;但 png 图片、robot

一、故障现象:动态页全挂,静态页没事

网站全线异常。症状非常有规律:首页及所有动态页面一律返回 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,最后修驱动或版本、清缓存、删测试文件。一步一个脚印,问题早晚会暴露。

 
关注重庆资讯网微信公众号(微信搜索"023086"),了解更多精彩重庆资讯。
【免责声明】重庆资讯网未标有“来源:重庆资讯网”或“重庆资讯网LOGO、水印的文字、图片、音频、视频”等稿件均为转载稿。如转载稿涉及版权等问题或您不希望出现在本站,请联系我们。
反对 0举报收藏 0打赏 0评论 0
 
更多>同类重庆动态
广告
推荐图文
推荐重庆动态
点击排行
网站首页  |  关于我们  |  联系方式  |  合作伙伴  |  使用协议  |  隐私政策  |  免责声明  |  网站地图  |  排名推广  |  广告服务  |  积分换礼  |  RSS订阅
Google PageRank Checker Copyright © 2011-2026 重庆资讯网 版权所有 Powered By DESTOON
安全联盟 不良举报  文明转播  行业协会 360网站安全检测 Valid CSS!