宝塔PHP不同版本函数差异在哪_常用函数变更说明【介绍】

php 7.4 升级到 8.0 后 jsonencode() 默认不再将 NULL 键数组隐式转对象，mbstring 默认编码改为 UTF-8，mysql* 函数已移除，str_contains() 等新函数需对应 PHP 版本支持。

PHP 7.4 升级到 8.0 后 json_encode() 行为变化最明显

默认不再自动将 null 键数组转为对象，而是保持关联数组语义。如果你的接口返回 JSON 时依赖旧版“空键 → 对象”的隐式转换（比如 json_encode([null => 'a']) 在 7.4 返回 {"": "a"}，8.0 返回 {"": "a"} 表面一样，但内部键类型处理更严格），实际在解码端用 json_decode($str, true) 时差异不大；但若省略第二个参数，8.0 的对象属性访问会更“干净”，不会因键名是空字符串导致 $obj->"" 报错。

实操建议：

• 检查所有未显式传 true 的 json_decode() 调用，确认业务是否依赖对象属性动态访问
• 避免用 array_keys($arr) === range(0, count($arr)-1) 判断索引数组——PHP 8.0+ 对 json_encode() 输出的数组结构判断更保守，建议改用 array_is_list($arr)（PHP 8.1+）或 !array_keys($arr) !== array_keys(array_values($arr))
• 升级前用 php -l 扫描 + 开启 E_DEPRECATED 日志，重点关注 json_encode() 相关警告

宝塔中切换 PHP 版本后 mbstring 编码函数默认行为不一致

PHP 7.3 及以前，mb_internal_encoding() 默认是 ISO-8859-1；从 7.4 开始默认改为 UTF-8。这意味着没显式调用 mb_internal_encoding('UTF-8') 的老代码，在 7.4+ 下可能因内部编码假设错误，导致 mb_substr()、mb_strlen() 计算中文字符长度出错（比如返回字节数而非字符数）。

常见错误现象：

立即学习“PHP免费学习笔记（深入）”；

• 用户昵称截取后显示乱码或丢失字符
• mb_strpos($haystack, $needle) 在含中文的字符串中返回 false（实际存在）
• 宝塔面板里启用“防跨站攻击”后，mb_* 函数突然失效（因 open_basedir 限制与编码检测逻辑耦合）

实操建议：

• 所有项目入口文件第一行加 mb_internal_encoding('UTF-8');，不要依赖默认值
• 检查 php.ini 中 mbstring.internal_encoding 是否被宝塔模板覆盖（路径如 /www/server/php/80/etc/php.ini），该配置项在 PHP 8.0+ 已废弃，仅作兼容保留
• 用 mb_detect_encoding($str, ['UTF-8', 'GB2312'], true) 替代盲目 mb_convert_encoding()，避免二次转码

mysql_connect() 类函数在 PHP 7.0+ 彻底移除，但宝塔部分旧插件仍残留调用

宝塔 7.x 面板本身已不用 MySQL 扩展，但用户安装的第三方 PHP 插件（如某些老版 wordPress 缓存组件、Discuz! X2 插件）可能还在调用 mysql_connect()、mysql_query()。PHP 7.0 起这些函数直接报 Fatal Error: Uncaught Error: Call to undefined function mysql_connect()，不是警告，无法忽略。

使用场景判断：

• 错误日志里出现 Call to undefined function mysql_*，且确认代码没用 mysqli 或 pdo
• 宝塔软件商店安装的“PHP 扩展”里勾选了 mysql（这是误导！该选项只控制 php-mysql 包安装，不提供 mysql_* 函数）

实操建议：

• 用 grep -r "mysql_connect|mysql_query" /www/wwwroot/ 全盘扫描网站目录
• 替换方案优先级：PDO > mysqli（面向对象） > mysqli（过程式）；不要用 mysqli_*() 简单替换 mysql_*()，因为连接参数顺序、错误处理机制不同
• 若必须兼容，可临时加一层兼容函数（仅限过渡）：

  if (!function_exists('mysql_connect')) {     function mysql_connect($host, $user, $pass, $new = false, $client = 0) {         return mysqli_connect($host, $user, $pass);     } }

  但注意 mysql_select_db() 等需同步适配，且不支持持久连接

PHP 8.1+ 的 str_contains() 等新函数在宝塔低版本 PHP 中不可用

宝塔允许共存多个 PHP 版本，但很多用户误以为“装了 8.1 就能用新函数”，忽略了 composer autoload 或框架自动降级机制。例如 laravel 9+ 默认要求 PHP 8.0+，但若在宝塔里给站点指定的是 PHP 7.4，即使服务器装了 8.1，str_contains('hello', 'ell') 仍会报 Call to undefined function str_contains()。

性能与兼容性影响：

• str_contains() 比 strpos($a, $b) !== false 快约 15%（PHP 8.1+ 内部优化），但降级写法在 7.4~8.0 完全兼容
• array_is_list() 在 8.1+ 是 O(1)，而手动遍历 array_keys() 是 O(n)，大数据量时差异明显
• 宝塔的“PHP 版本切换”只改 nginx/apache 的 php-fpm socket 路径，不校验实际运行时函数可用性

实操建议：

• 检查站点根目录下 .user.ini 或宝塔站点设置里的“PHP 版本”，确认与 phpinfo() 显示一致
• 用 function_exists('str_contains') 包裹新函数调用，而不是全局替换
• CI 流程中增加 php -v && php -r "echo function_exists('str_contains') ? 'ok' : 'fail';" 校验步骤

宝塔里 PHP 版本切换看着点几下就完事，真正麻烦的是那些没报错但结果不对的函数行为偏移——比如 json_encode() 不报错却让前端解析失败，mb_strlen() 不报错却让分页错位。这些得靠真实请求链路验证，不能只看 phpinfo 或单元测试。