PHP substr截取中文乱码,mb_substr多字节字符串处理

雨丽君_2819

雨丽君_2819

2026-10-04

934人浏览

原创

substr按字节截中文必乱码,因utf-8中文占3字节;mb_substr必须显式指定'utf-8'编码,否则易错;mb_strcut按字节截取,仅适用于二进制场景;负索引需先用mb_strlen确认字符数,且须确保mbstring扩展已启用。

php substr截取中文乱码,mb_substr多字节字符串处理

直接用 substr() 截中文,乱码是必然的——它根本不管字符边界,只按字节硬切。UTF-8里一个中文占3字节,substr("你好", 0, 2) 切出来就是两个残缺字节,浏览器一渲染就显示或一堆问号。

mb_substr() 必须指定 encoding 参数

很多人写了 mb_substr($str, 0, 10) 还是乱码,问题就出在没传编码。PHP 的内部编码(mb_internal_encoding())不一定等于你字符串的实际编码,尤其当数据来自数据库、API 或表单时。

  • 显式传 'UTF-8' 最稳妥,99% 的现代 PHP 项目都用这个
  • 别依赖默认值:如果 mb_internal_encoding() 是 ISO-8859-1,而你传的是 UTF-8 字符串,结果照样错
  • 用 mb_detect_encoding($str, ['UTF-8', 'GB2312', 'BIG5'], true) 做兜底检测,但别在高频路径里用,性能差

mb_substr 和 mb_strcut 的行为差异很关键

这两个函数名字像、参数一样,但底层逻辑完全不同,选错会出线上问题。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

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

下载
  • mb_substr() 数“字符”:你写 mb_substr($str, 0, 5, 'UTF-8'),就一定得 5 个完整字符,哪怕它们总共占 15 字节
  • mb_strcut() 数“字节”:你写 mb_strcut($str, 0, 5, 'UTF-8'),它从第 0 字节开始拿 5 字节,如果第 4~5 字节正好卡在一个中文字符中间,就返回 "你好?" 这类带替代符的结果
  • 做摘要、前端展示、用户可见内容,必须用 mb_substr();只有处理二进制流、协议包、或明确要控制字节数(比如 Redis key 长度限制)才考虑 mb_strcut()

常见错误:负数索引 + 中文混排时行为反直觉

mb_substr($str, -2, 1) 看似“取倒数第二个字符”,但实际行为取决于编码和字符串组成。例如:

$str = "a你好b"; // ASCII + UTF-8 混合
echo mb_substr($str, -2, 1, 'UTF-8'); // 输出 "好"(不是 "b")

因为 mb_substr 是按字符位置算的:"a你好b" 共 5 个字符,索引是 0→a, 1→你, 2→好, 3→b;-2 就是索引 3,所以取到的是 "b"?不对——等等,再数一遍:a(0)、你(1)、好(2)、b(3),共 4 个字符。那 -2 就是索引 2 → “好”。

  • 混排字符串中,永远先用 mb_strlen($str, 'UTF-8') 确认总字符数,再算负索引对应的位置
  • 避免在动态长度字符串上直接写 -n,尤其当内容来自不可信输入时(比如用户昵称含 emoji,一个 emoji 可能占 4 字节、算 1 字符)
  • 如果真要“取末尾 N 个字符”,写成 mb_substr($str, -N, null, 'UTF-8') 比 mb_substr($str, -N, N, 'UTF-8') 更安全,省得自己算错

最常被忽略的一点:mbstring 扩展不是默认启用的。上线前不检查 extension=mbstring 是否在 php.ini 里生效,或者没确认 Docker 镜像/云函数运行时是否预装,mb_substr() 直接报 Call to undefined function —— 这种错误不会在本地开发环境暴露,专等发布后炸。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9884

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5901

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2075

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3688

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4374

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3431

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4897

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3822

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11802

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
《20天入门精通PHP》视频教程
《20天入门精通PHP》视频教程

共200课时 | 48.2万人学习

墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习