mb_trim() 是 php 8.4 新增的函数，用于移除字符串两侧的空白字符或其他指定字符。在 php 8.3 及更低版本中，可以通过定义一个 polyfill 函数来实现完全兼容，该函数内部调用 mb_ereg_replace 或正则表达式来模拟其行为。
如何定义 mb_trim 的 polyfill 函数
在 PHP 8.3 及以下版本中，直接调用 mb_trim() 会导致致命错误。解决方法是在代码加载时检查函数是否存在，如果不存在则定义一个同名函数。这个 polyfill 需要接受与原生函数相同的参数：$string、$characters 和 $encoding。核心逻辑是使用 mb_ereg_replace 配合锚点 ^ 和 $ 来匹配并替换首尾的字符。
if (!function_exists('mb_trim')) {
function mb_trim($string, $characters = "\u{0020}\u{0009}\u{000a}\u{000b}\u{000c}\u{000d}\u{00e0}\u{180e}", $encoding = null) {
if ($encoding === null) {
$encoding = mb_internal_encoding();
}
// 构建正则表达式：匹配开头或结尾的指定字符
// 注意：mb_ereg_replace 使用 POSIX 扩展正则，需转义特殊字符
$escaped_chars = preg_quote($characters, '/');
$pattern = "/^({$escaped_chars}*)|({$escaped_chars}*)$/";
return mb_ereg_replace($pattern, '', $string, '', $encoding);
}
}
上述代码首先检查 function_exists，确保不会重复定义。接着处理默认编码，通常回退到 mb_internal_encoding()。正则表达式部分，preg_quote 用于安全地转义用户传入的 $characters 中的特殊正则符号。模式 /^(chars*)|(chars*)$/ 分别匹配头部和尾部。最后通过 mb_ereg_replace 将匹配到的部分替换为空字符串。
polyfill 在不同编码下的行为差异
在使用 polyfill 时，必须显式或隐式指定正确的 $encoding 参数，否则 mb_ereg_replace 可能无法正确处理多字节字符（如 UTF-8 中文）。PHP 8.4 的原生 mb_trim() 会自动检测或使用内部编码，而 polyfill 若未正确传递编码，可能导致截断错误或乱码。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
// 测试用例 $string = " hello world "; $trimmed = mb_trim($string); echo $trimmed; // 输出: "hello world" // 带自定义字符 $string2 = "...hello..."; $trimmed2 = mb_trim($string2, "."); echo $trimmed2; // 输出: "hello" // 多字节字符 $string3 = " 你好世界 "; $trimmed3 = mb_trim($string3, null, 'UTF-8'); echo $trimmed3; // 输出: "你好世界"
在测试中，第一段代码展示了基本用法，移除空格。第二段代码演示了自定义字符 . 的移除。第三段代码特别强调了 UTF-8 编码下多字节字符的处理。如果省略第三个参数，polyfill 会使用 mb_internal_encoding()，这可能与实际字符串编码不一致，导致问题。因此，在生产环境的 polyfill 中，建议始终明确指定编码，或在文档中提醒开发者注意这一点。
基于输入空值时的边界情况处理
当输入 $string 为空字符串或仅包含被移除字符时，mb_trim() 应返回空字符串。Polyfill 必须正确处理这种情况，避免返回 false 或引发警告。在 PHP 8.4 中，mb_trim("") 返回 ""。我们的 polyfill 使用 mb_ereg_replace，当无匹配时返回原字符串，因此对于空输入，它也会返回空字符串，符合预期。
$empty = ""; $result = mb_trim($empty); var_dump($result); // string(0) "" $only_chars = "..."; $result2 = mb_trim($only_chars, "."); var_dump($result2); // string(0) ""
以上测试验证了边界情况。第一个测试中，空字符串输入后，输出仍为空字符串。第二个测试中，字符串仅由待移除字符组成，移除后也应为空字符串。这两个结果都与 PHP 8.4 原生行为一致。需要注意的是，mb_ereg_replace 在失败时可能返回 false，但在成功执行且无匹配时返回原字符串。因此，在 polyfill 实现中，无需额外检查返回值类型，因为正则引擎的行为已保证正确性。然而，为了绝对健壮，可以在 polyfill 末尾添加 return $result === false ? '' : $result;，但这在大多数情况下不是必需的。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
