mb_strcut是PHP中按字节截取多字节字符串的函数,优先保证字节边界安全而非字符完整,适用于数据库字段限制等场景,执行比mb_substr快约15%但可能返回少于指定字节数的合法字符序列。

mb_strcut 在 PHP 7.4 中是一个按字节截取多字节字符串的函数,适合对 UTF-8 等编码做**字节长度限制型截取**,比如存入固定长度字段、生成摘要前处理等。它不保证字符完整性,但比 mb_substr 更快、更贴近底层存储需求。
基本用法和参数含义
函数签名:
mb_strcut(string $str, int $start, ?int $length = null, ?string $encoding = null): string
- $str:要处理的原始字符串(必须是多字节编码,如 UTF-8)
- $start:起始字节位置(从 0 开始计数;负数表示从末尾倒数)
-
$length:要截取的字节数(省略或为
null表示取到末尾;负数表示从末尾往前截) -
$encoding:显式指定编码(强烈建议写
'UTF-8',避免依赖mb_internal_encoding()配置)
常见使用场景与示例
✅ 限制数据库字段长度(按字节)
MySQL 的 VARCHAR(50) 是按字节算的,中文在 UTF-8 下占 3 字节,直接用 substr 可能截断出乱码,mb_strcut 会自动回退到最近的合法字符起点:
$title = "PHP多字节字符串处理与图像缩略函数详解";<br>echo mb_strcut($title, 0, 50, 'UTF-8'); // 安全截成 ≤50 字节,不会出现半个汉字
✅ 配合负偏移提取后缀
比如取文件扩展名的前 10 字节(含中文扩展名):
$filename = "报告_2024年总结.pdf";<br>echo mb_strcut($filename, -10, null, 'UTF-8'); // 从末尾倒数 10 字节开始取到结尾
✅ 防乱码的“安全截断”封装
可结合 mb_check_encoding 做兜底:
if (mb_check_encoding($text, 'UTF-8')) {<br> $safe = mb_strcut($text, 0, 100, 'UTF-8');<br>} else {<br> $safe = substr($text, 0, 100); // 降级为单字节截取<br>}
和 mb_substr 的关键区别
⚠️ 不要混淆两者的用途:
-
mb_substr($s, 0, 5, 'UTF-8')→ 截前 5 个“字符”,结果一定是 5 个完整汉字/字母 -
mb_strcut($s, 0, 5, 'UTF-8')→ 截前 5 个“字节”,若第 5 字节落在某个中文字符中间(如只取了前 2 字节),它会自动把整个该字符包含进来,所以实际返回可能只有 3 或 4 个字符,但字节流是合法的
也就是说:mb_strcut 优先保证**字节边界安全**,不是字符数量精确控制。
注意事项
• 如果 $start 超出字符串总字节数,返回空字符串(不是 false)
• $length 为负数时,行为类似 substr:从末尾倒推字节数作为结束点
• PHP 7.4 已支持 $encoding = null,但不推荐省略,否则依赖 php.ini 的 default_charset 或 mb_internal_encoding() 设置,易出错
• 实测中,对纯 ASCII 字符串,mb_strcut 和 substr 行为一致;对中文混排,差异明显
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











