修复 Typecho 旧版本主题在 PHP 7.4 以上版本不兼容问题，最推荐的处理方向是升级服务器 PHP 环境至 7.4 或 8.0，并修改主题代码中已废弃的数据库连接函数和类继承结构。

命令速用版

若具备服务器 SSH 权限，可通过以下命令快速检查环境版本与语法错误，辅助定位兼容性问题。

php -v
php -l /path/to/theme/functions.php

若无命令行环境，直接在宝塔面板「网站」→「设置」→「PHP 版本」中查看当前版本，并使用在线 PHP 语法检查工具扫描主题核心文件。

为什么会这样

PHP 7.4 及以上版本移除了旧的 mysql 扩展，且 Typecho 1.3.0 后重构了 Widget 系统命名空间，导致旧代码无法调用。

绝大多数现代 PHP 应用已停止兼容 PHP 5.6/7.0，当服务器检测到站点运行版本低于安全阈值或代码调用了如 mysql_connect() 等彻底消失的函数时，会直接导致白屏或报错。Typecho 在 1.3.0 版本中将数据库访问层从静态调用升级为面向对象设计，旧主题继承的 Widget_Abstract_Contents 等类名在新版中已变更为 Widget\Base\Contents，未适配的主题因此无法加载数据。

分步处理

按以下顺序修改配置与代码，确保每一步修改后都能回滚。

第一步：备份站点文件与数据库

在修改任何代码前，通过 FTP 下载主题文件夹，并在宝塔面板导出数据库 SQL 文件，防止修改错误导致站点无法恢复。

第二步：修改数据库连接配置

打开站点根目录下的 config.inc.php 文件，查找数据库驱动配置。若发现代码中使用 mysql 引擎，需将其修改为 pdo_mysql，因为 PHP 7.x 已去掉老掉牙的 mysql 引擎，使用了 mysqli 引擎。

修改前：$db = new Typecho_Db('mysql', 'typecho_');

修改后：$db = new Typecho_Db('pdo_mysql', 'typecho_');

第三步：修复主题 Widget 类继承

打开主题目录下的 functions.php 或 widget.php 文件，搜索 class 关键字。若发现继承自 Widget_Abstract_Contents 等旧类名，需添加版本检测兼容代码。

兼容写法示例：if(class_exists('Widget\Base\Contents')){ class Widget_Contents_Hot extends Widget\Base\Contents{} }else{ class Widget_Contents_Hot extends Widget_Abstract_Contents{} }

第四步：清理废弃 PHP 函数

全局搜索主题文件中的 mysql_connect、mysql_query 等函数，替换为 mysqli_connect 或 PDO 写法。同时检查是否有 preg_replace 使用/e 修饰符，需改为 preg_replace_callback。

怎么验证是否生效

修改完成后，清除浏览器缓存并刷新网站首页，观察文章列表是否不再显示 loading 状态。

登录 Typecho 后台，查看是否有 PHP 警告或错误日志。若使用宝塔面板，可在「网站」→「日志」中查看 error.log，确认没有 Fatal error: Uncaught Error 或 Call to undefined function 类报错。

常见坑

部分移植主题在 footer.php 中插入了非 Typecho 标准的统计代码，包含 wp_head 或 get_header 等 WordPress 函数，这些代码会与插件自带的统计模块冲突，需删除主题中所有百度相关代码，仅保留插件提供的接口。

升级 PHP 版本后，若站点仍报错，检查是否安装了 opcache、fileinfo、curl 等必要扩展，部分扩展在 PHP 7.4+ 默认不提供，若站点依赖它，得手动编译或改用 redis。

常见问题

PHP 8.0 能直接运行旧 Typecho 主题吗？

不能直接运行，PHP 8.0 废弃了$str{0}等语法且加强了类型检查，旧主题需额外修复数组下标访问和类型声明。

修改代码后网站白屏怎么办？

立即通过 FTP 还原备份的主题文件，或临时将 PHP 版本切换回 7.2，再逐步排查具体报错文件。

必须升级 Typecho 核心程序吗？

不一定，若仅主题不兼容，可仅修改主题代码；但若核心程序版本过低，建议同步升级至 1.3.0+ 以获得更好的 PHP 8 支持。

参考来源

• 为什么宝塔面板网站后台频繁提示 PHP 版本过低_进入站点设置将 PHP 一键升级至 7.4 以上
• Typecho 1.3.0+ 与 Joe 7.7.1 主题不兼容导致首页文章一直 loading 的解决方案
• 「【typecho】关于 typecho 不支持 PHP7.0 的解决办法」
• 如何解决 PHP7.4 在升级过程中可能出现的兼容性错误
• typecho 插件百度 seo 报错常见问题，后台设置冲突，服务器环境排查，站点收录异常修复