360 Secure SkillHub
360 安全技能中心

Empirecms7 Php8 Upgrade

面向帝国CMS 7.5 的 PHP 8 兼容性升级指南，覆盖 count 包装、未定义变量、magic_quotes_gpc、preg_replace_callback、create_function、split、mysql 扩展、数组键引号、字符串比较等 15 类问题，并给出备份、批量替换、验证步骤。

ebandao777-oss
ebandao777-oss
热度 16.00
最近更新 2026-06-18 18:49:21
分类：开发依赖：读写文件应用场景：调试排错 / 代码审查 / 代码生成 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add empirecms7-php8-upgrade
Metadata
name
empirecms7.5-php8-upgrade
description
帝国CMS 7.5 升级到 PHP 8 兼容性修改完整清单。当用户需要将帝国CMS 7.5 升级到 PHP 8、修复 PHP 8 致命错误、或从 PHP 7.x 迁移到 PHP 8 时调用。

帝国CMS 7.5 PHP 8 兼容性升级技能（完整版）

本技能提供帝国CMS 7.5 升级到完全兼容 PHP 8.x 的完整方法论。基于对可运行 PHP 8 兼容版本的逆向分析总结，覆盖语法兼容、语义兼容及运行时环境适配。

何时调用

  • 用户需要将帝国CMS 7.5 升级到 PHP 8
  • 用户报告 PHP 8 致命错误（白屏、TypeError、Fatal Error 等）
  • 用户需要修复帝国CMS的 PHP 8 兼容性问题
  • 用户询问 php8_count、get_magic_quotes_gpc、preg_replace /e、create_function、split、字符串比较异常等问题

核心修改方法（15 大类）

1. php8_count() 包装函数（最关键）

问题：PHP 8 中 count() 对 null/非数组参数抛出 TypeError。

解决方案：在 e/class/connect.php 末尾（?> 之前）添加包装函数：

//为了count for php8
function php8_count($a){
    return is_array($a) ? count($a) : 0;
}

应用范围：将以下文件中的 count($var) 替换为 php8_count($var)：

e/class/*.php（functions.php、connect.php、hinfofun.php、com_functions.php 等）
e/admin/*.php 及其子目录
e/member/*.php
e/action/*.php
e/pl/*.php、e/search/*.php、e/ShopSys/*.php 等

例外与性能注意：当变量确定是数组时保留原生 count()（如 count(array(1,2,3)) 或数据库结果集）。仅在变量来源不确定时使用 php8_count()，避免高频循环中的性能损耗。

2. isset() 未定义变量检查（安全模式）

问题：PHP 8 对未定义变量访问抛出 Warning，且在 isset() 之前直接访问变量名本身也可能触发警告。

解决方案：优先在函数签名中设置默认值，而非在函数体内赋值：

// 推荐：函数签名默认值
function RepClassid($classid = null) { ... }

// 备选：仅当无法修改签名时使用 func_get_arg
$classid = func_num_args() > 0 ? func_get_arg(0) : null;

应用范围：e/class/.php、e/admin/.php、e/member/.php、e/ShopSys/.php 中使用 $classid 等未初始化变量的函数。

3. magic_quotes_gpc 兼容性

问题：get_magic_quotes_gpc() 在 PHP 8 中已移除。

解决方案：在 e/class/connect.php 中：

define('MAGIC_QUOTES_GPC', function_exists('get_magic_quotes_gpc') && get_magic_quotes_gpc());

4. error_reporting 调整

问题：PHP 8 弃用警告会破坏输出。

解决方案：在 e/class/connect.php 中：

// 文件顶部
error_reporting(E_ALL ^ E_NOTICE ^ E_DEPRECATED);

// 后台页面
error_reporting(E_ALL & ~E_WARNING & ~E_DEPRECATED & ~E_USER_DEPRECATED);

5. preg_replace_callback() 替代 /e 修饰符

问题：/e 修饰符在 PHP 7.2+ 中已移除。

解决方案：在 e/class/SendEmail.inc.php 和 e/class/connect.php 中：

$encoded = preg_replace_callback(
    "/([\001-\010\013\014\016-\037\075\177-\377])/",
    function($m) { return '='.sprintf('%02X', ord($m[1])); },
    $encoded
);

特别注意：SendEmail.inc.php 第 1244、1247 行的 /e 修饰符必须手动确认修复状态。若未修复，邮件编码功能将完全不可用并抛出致命错误。

6. each() 改为 foreach

问题：each() 在 PHP 8 中已移除。

解决方案：在 e/class/doiconv.php、e/install/data/fun.php 中：

foreach($tmp as $key => $value) { ... }

7. 类构造函数 __construct()

问题：PHP 4 风格构造函数（方法名=类名）已弃用。

解决方案：在 e/class/SendEmail.inc.php、e/class/doiconv.php 中将同名方法改为 __construct()。

8. mysql_* 改为 mysqli_*

问题：mysql_* 扩展在 PHP 7+ 中已移除。

解决方案：

设置 e/config/config.php：$ecms_config['db']['usedb'] = 'mysqli';
如果 e/class/db/db_mysql.php 被加载，将所有 mysql_* 转换为 mysqli_*
注意参数顺序不同：mysql_query($sql, $link) 改为 mysqli_query($link, $sql)

9. 数组键加引号

问题：未加引号的数组键如 $var[key] 在 PHP 8 中抛出 Error。

解决方案：为所有数组键添加单引号：

// 原代码（PHP 8 Error）
$_GET[classid]
$_POST[from]
$class_r[$classid][featherclass]

// 修复后
$_GET['classid']
$_POST['from']
$class_r[$classid]['featherclass']

例外：在双引号字符串中 $var[key] 是合法 PHP 语法，但仍建议使用 {$var['key']} 花括号语法。

10. PHP 4 风格 var $ 属性声明

问题：var $ 属性声明在 PHP 8.1+ 中已弃用。

解决方案：在 e/class/ftp.php、e/class/phpzip.inc.php 中：

class ftp {
    public $ftpconnectid;
    public $ftptranmode;
}

11. 字符串与数字比较行为变更（高危语义陷阱）

问题：PHP 8 改变了非严格比较规则。0 == "foo" 在 PHP 7 中为 true，在 PHP 8 中为 false。帝国CMS 大量使用 $classid == 0、$id != "" 等宽松比较来判断栏目ID或内容ID。

后果：当变量为空字符串 "" 或 "0" 时，条件判断结果反转，导致栏目导航丢失、分页失效或权限校验绕过。

解决方案：将关键业务逻辑中的 == / != 改为 === / !==，或对 $classid、$id 等核心变量强制 (int) 转型后再比较：

// 推荐：强制转型后严格比较
if ((int)$classid === 0) { ... }

// 推荐：严格不等于
if ($id !== '') { ... }

12. implode() 参数顺序与 create_function() 移除

问题A：implode($pieces, $glue) 反向调用在 PHP 8 中已移除，直接抛出 Fatal Error。

问题B：create_function() 在 PHP 8 中完全移除，影响模板解析引擎和自定义标签处理。

解决方案：

// implode 修复：确保 glue 在前
$str = implode(',', $array);

// create_function 修复：替换为闭包
// 原代码
$callback = create_function('$matches', 'return strtoupper($matches[1]);');
// 修复后
$callback = function($matches) { return strtoupper($matches[1]); };

13. split() 函数移除（新增遗漏项）

问题：split() 基于正则分割字符串，在 PHP 7.0 中已移除，PHP 8 中调用直接 Fatal Error。帝国CMS 部分旧版插件和自定义标签中仍在使用。

解决方案：统一替换为 explode()（按固定分隔符）或 preg_split()（按正则）：

// 原代码
$arr = split(',', $str);
// 修复后（固定分隔符用 explode）
$arr = explode(',', $str);

// 原代码（正则分隔）
$arr = split('[,;|]', $str);
// 修复后
$arr = preg_split('/[,;|]/', $str);

14. GBK 编码环境 mbstring 兼容（新增遗漏项）

问题：PHP 8 移除了 mbstring.func_overload 配置项。若服务器原先依赖该配置实现 GBK 站点中文处理，升级后会出现乱码或截取异常。帝国CMS 7.5 GBK 版受影响尤为严重。

解决方案：

确认 e/class/connect.php 中所有字符串操作使用 mb_substr/mb_strlen 时显式传入 'GBK' 编码参数
不再依赖 mbstring.func_overload 自动重载
UTF-8 版站点可忽略此项

15. 模板标签解析引擎适配（新增遗漏项）

问题：帝国CMS 的灵动标签、万能标签解析器内部使用 create_function() 动态生成回调，是第 12 条的特化场景。仅替换通用 create_function 可能遗漏标签解析器中的嵌套调用。

解决方案：重点检查以下文件中的 create_function 调用：

e/class/functions.php（ReplaceListVars、DoTempletTag 等函数）
e/class/t_functions.php
e/class/q_functions.php

将每个 create_function 逐一替换为匿名闭包，注意保持参数列表和返回值语义一致。

执行步骤

第一步：备份

xcopy /E /I /Y "项目目录" "项目目录_php8备份"

第二步：添加核心兼容函数

编辑 e/class/connect.php：

  • 在文件末尾添加 php8_count() 函数
  • 修复 MAGIC_QUOTES_GPC 定义
  • 调整文件顶部的 error_reporting
  • 将 preg_replace /e 替换为 preg_replace_callback

第三步：应用 php8_count() 替换

对项目中的所有目标文件执行批量替换，将 count($var) 替换为 php8_count($var)，注意保留确定数组类型的原生 count() 调用。

第四步：修复未定义变量

逐一检查 e/class、e/admin、e/member 目录下的函数，为缺少默认值的参数添加 null 默认值或使用 func_get_arg 兜底。

第五步：修复数组键引号

使用正则搜索 $(GET|POST|REQUEST|SESSION|COOKIE)[[a-zA-Z]+] 和 $class_r[.*?][[a-zA-Z_]+]，为裸键名添加单引号。

第六步：修复 create_function 与 split

全局搜索 create_function 和 split(，按第 12、13、15 条逐一替换为闭包和 explode/preg_split。

第七步：验证与测试

  • 开启 error_reporting(E_ALL) 进行全量扫描
  • 重点测试后台登录、栏目管理、内容发布、前台首页、搜索、评论、会员系统
  • 确认邮件发送功能正常（SendEmail.inc.php）
  • 确认 FTP 上传和 ZIP 解压功能正常
  • 确认灵动标签、万能标签在前台正常渲染（模板解析引擎）
  • GBK 站点额外测试中文标题截取、搜索关键词高亮是否正常