PHP7.4的mb_str_split,PHP7.3分割多字节字符串替代-php教程-PHP中文网

php 7.3 缺失 mb_str_split，需用 mb_substr 循环实现；7.4+ 引入该函数但需显式指定编码，兼容方案应封装统一入口并避免 preg_split('//u') 等不可靠替代。

php7.4的mb_str_split,php7.3分割多字节字符串替代

PHP 7.3 没有 `mb_str_split`，得自己实现

PHP 7.4 才引入 mb_str_split，7.3 及更早版本调用它会直接报 Fatal error: Uncaught Error: Call to undefined function mb_str_split()。这不是配置问题，是函数根本不存在——别折腾 mbstring 扩展开关，没用。

常见错误是把 str_split 当成多字节安全的来用：str_split('?‍?abc', 1) 在 UTF-8 下会把 emoji 拆成乱码字节，结果是 ['', '', '', '', 'a', 'b', 'c']，而非预期的 ['?‍?', 'a', 'b', 'c']。

必须用 mb_substr 配合循环，每次取长度为 1 的子串
不能依赖 strlen，得用 mb_strlen($str, 'UTF-8') 获取真实字符数
显式指定编码（如 'UTF-8'）比用 mb_internal_encoding() 更可靠，后者可能被运行时修改

`mb_str_split` 在 PHP 7.4+ 的行为细节

PHP 7.4 的 mb_str_split 默认按字符切分，但要注意：它不等价于反复调用 mb_substr($str, $i, 1) —— 它内部做了优化，且对空字符串、负数 $split_length 有明确定义。

比如 mb_str_split('a€?', 2) 返回 ['a€', '?']，而 mb_str_split('a€?', 1) 返回四个元素；但若传 0 或 null，会返回空数组，不是抛错。

第二个参数 $split_length 必须是正整数，否则返回空数组（PHP 7.4.0–7.4.33 行为一致）
不传第三个参数时，默认使用 mb_internal_encoding()，但建议显式写 'UTF-8' 避免隐式依赖
性能上比手写循环快约 15–20%，尤其长字符串，因避免了多次函数调用开销

兼容 PHP 7.3/7.4 的安全分割函数

要同时跑在 7.3 和 7.4 上，别用特性检测（function_exists('mb_str_split')）然后分支调用——容易漏掉编码参数一致性问题。直接封装一个统一入口：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

function mb_str_split_compat(string $str, int $split_length = 1, string $encoding = 'UTF-8'): array
{
    if ($split_length =') && function_exists('mb_str_split')) {
        return mb_str_split($str, $split_length, $encoding);
    }
    $result = [];
    $len = mb_strlen($str, $encoding);
    for ($i = 0; $i 
<p>这个函数在两种版本下行为一致，且明确控制编码，避免因 <code>mb_internal_encoding()</code> 被意外修改导致线上字符截断。</p>

注意：不要省略 $encoding 参数传入 mb_substr，否则默认用内部编码，不可靠
如果项目已强制设定了 mb_internal_encoding('UTF-8') 且永不更改，可简化，但生产环境不推荐这种假设
emoji、中文、日文混合时，$split_length > 1 仍可能跨字符边界（如 mb_substr($str, 0, 2) 截到半个 emoji），这是多字节字符串固有限制，无法绕过