PHP mb_substr() 函数（长文解析）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言：为什么需要 mb_substr() 函数？

在 PHP 开发中，字符串操作是基础且高频的需求。然而，当处理包含中文、日文、韩文等多字节字符时，传统的 substr() 函数往往会出现令人困惑的错误。比如截取中文字符串时，可能会得到半截的乱码符号，甚至引发不可预估的 Bug。

此时，mb_substr() 函数便如同一把精准的手术刀，能完美解决多字节字符的截取问题。它像是一位精通国际物流的快递员，能准确识别不同语言字符的“包裹体积”，确保每次操作都精准无误。

本文将从基础用法到进阶技巧，系统性讲解 mb_substr() 函数的使用方法，帮助开发者避免“字符串截取陷阱”，提升多语言应用的开发效率。

基础使用：函数语法与核心参数解析

函数基本语法

string mb_substr ( string $string , int $start [, int $length [, string $encoding ]] )

参数详解

形象比喻：
可以把字符串想象成一列等待装箱的货物，每个字符是不同体积的包裹。mb_substr() 函数就像一位经验丰富的仓储管理员，能准确计算每个包裹的体积（字符编码），并按照指定的起始位置和数量进行精准分拣。

参数深度解析：从简单到复杂

1. start 参数的特殊性

当 start 参数为负数时，表示从字符串末尾开始倒数：

$string = "PHP编程入门指南";
echo mb_substr($string, -4); // 输出：入门指南

2. length 参数的隐藏功能

当不指定 length 参数时，默认截取到字符串末尾：

echo mb_substr("Hello World", 6); // 输出：World

3. encoding 参数的全局影响

若未指定编码格式，则使用 PHP 的内部编码设置：

mb_internal_encoding("UTF-8"); // 设置全局编码
echo mb_substr("你好，世界", 3); // 输出：，世界

实战案例：常见场景解析

案例1：中文字符串截取

$chinese_str = "PHP是一门优雅的编程语言";
$result = mb_substr($chinese_str, 4, 6); // 截取从第5个字符开始的6个字符
echo $result; // 输出：一门优雅

案例2：处理特殊符号

$emoji_str = "🚀 PHP开发者必备技能 🚀";
$short_str = mb_substr($emoji_str, 3, 10); // 处理表情符号等多字节字符
echo $short_str; // 输出：PHP开发者

案例3：结合其他函数使用

function truncate_text($text, $length = 10) {
    if (mb_strlen($text) > $length) {
        return mb_substr($text, 0, $length) . "...";
    }
    return $text;
}

echo truncate_text("PHP核心技术解析", 7); // 输出：PHP核... 

注意事项：隐藏的“坑”与解决方案

1. 编码设置的重要性

若未正确设置编码格式，可能导致截取失败：

// 错误示例：未指定编码
$str = "你好世界";
echo mb_substr($str, 0, 2); // 可能输出：??（取决于服务器默认编码）

// 正确做法：
mb_internal_encoding("UTF-8");
echo mb_substr($str, 0, 2); // 输出：你

2. 性能优化建议

处理超长字符串时，建议先通过 mb_strlen() 获取长度再操作：

$text = file_get_contents("large_text_file.txt");
if (mb_strlen($text) > 1000) {
    $processed_text = mb_substr($text, 0, 1000);
}

3. 特殊场景处理

当需要保留完整汉字时，避免使用负数截取：

// 错误示例：
$intro = "PHP是一种广泛使用的服务器端脚本语言";
$short_intro = mb_substr($intro, -8); // 可能截取到半截汉字

// 改进方案：
$intro_length = mb_strlen($intro);
$short_intro = mb_substr($intro, 0, $intro_length-8);

进阶技巧：超越基础功能

技巧1：智能截断与省略号

function smart_truncate($str, $length) {
    if (mb_strlen($str) <= $length) return $str;
    return mb_substr($str, 0, $length - 3) . "...";
}

echo smart_truncate("PHP高级开发实战", 10); // 输出：PHP高级开...

技巧2：结合正则表达式优化

// 截取URL路径部分
$url = "https://example.com/articles/php-substr/";
$path = parse_url($url, PHP_URL_PATH);
$short_path = mb_substr($path, 0, 15);
echo $short_path; // 输出：/articles/php_s

技巧3：处理混合编码场景

// 当字符串包含多种编码时
mixed_str = "UTF-8与GB2312混合字符串";
mb_detect_order(["UTF-8", "GB2312"]);
echo mb_substr(mixed_str, 0, 5); // 自动检测并处理编码

与其他函数的对比：选择最佳工具

与 substr() 函数对比

与 mb_strcut() 函数的区别

mb_strcut() 是按字节截取的多字节函数，适合已知字节长度的场景：

// mb_strcut() 按字节操作
$byte_str = mb_strcut("你好世界", 3); // 截取从第4字节开始的内容

结论：掌握多字节字符串的正确姿势

通过本文的系统讲解，我们掌握了 mb_substr() 函数的核心用法、参数细节以及常见问题的解决方案。在多语言开发场景中，它如同一把精准的瑞士军刀，能有效避免字符串操作中的编码陷阱。

对于开发者而言，建议始终遵循以下原则：

1. 开发多字节字符串时优先使用 mb_* 系列函数
2. 保持编码设置的一致性（推荐 UTF-8）
3. 对超长字符串操作前先进行长度检测

掌握 PHP mb_substr() 函数 的精髓，不仅能提升代码质量，更能为开发国际化应用奠定坚实基础。建议读者通过实际项目练习，逐步内化这些核心技能。