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-fpmsocket 路径，不校验实际运行时函数可用性
实操建议：
- 检查站点根目录下
.user.ini或宝塔站点设置里的“PHP 版本”，确认与phpinfo()显示一致 - 用
function_exists('str_contains')包裹新函数调用，而不是全局替换 - CI 流程中增加
php -v && php -r "echo function_exists('str_contains') ? 'ok' : 'fail';"校验步骤
json_encode() 不报错却让前端解析失败，mb_strlen() 不报错却让分页错位。这些得靠真实请求链路验证，不能只看 phpinfo 或单元测试。 
