PHP 7升级至8时已移除的MB_OVERLOAD_STRING功能迁移方案咨询

首先可以明确：仅把strpos等基础字符串函数替换为mb_strpos等多字节函数的操作不完整，需要配合额外的配置和场景校验才能完成平滑迁移，完整迁移流程如下：

• 第一步：确认原有配置的作用范围
  之前开启MB_OVERLOAD_STRING（对应mbstring.func_overload配置值为2）时，PHP会自动把所有str*开头的单字节字符串函数重载为多字节版本，默认使用mbstring.internal_encoding指定的编码运行，绝大多数项目的默认编码都是UTF-8。
• 第二步：批量替换对应字符串函数
  需要把所有被重载的单字节函数替换为对应的mb_前缀多字节函数，常见对应关系如下：

  原生单字节函数 -> 替换后的多字节函数
  strpos -> mb_strpos
strrpos -> mb_strrpos
strlen -> mb_strlen
substr -> mb_substr
strtolower -> mb_strtolower
strtoupper -> mb_strtoupper
substr_count -> mb_substr_count
stripos -> mb_stripos
strripos -> mb_strripos
strstr -> mb_strstr
stristr -> mb_stristr
strrchr -> mb_strrchr
  替换时建议给所有mb_*函数显式指定第四个编码参数为'UTF-8'，避免依赖服务器默认配置的编码出现异常，示例：mb_strpos($content, '查找文本', 0, 'UTF-8')

• 第三步：处理特殊场景兼容性
  除了函数替换外，还需要完成以下调整：
  • 排查代码中用strlen计算二进制长度的场景，比如处理上传文件、二进制流、加密数据的逻辑，这部分不要替换为mb_strlen，保留原生strlen即可
  • 删除php.ini、.user.ini、代码 runtime 配置中所有涉及mbstring.func_overload的配置项，PHP 8已经不再识别该配置，保留会产生运行时警告
  • 在项目入口文件全局设置mbstring默认编码，添加代码mb_internal_encoding('UTF-8');，保证未显式指定编码的mb_*函数运行逻辑和之前重载时完全一致
• 第四步：功能校验
  完成修改后重点测试中文、日文等非ASCII多字节字符的查找、截取、长度计算相关逻辑，避免出现乱码、计算结果错误的问题。

内容的提问来源于stack exchange，提问作者Zlelik