ThinkPHP截取字符串乱码转换如何规避-php教程-PHP中文网

应使用 mb_substr() 并显式指定 'utf-8' 编码截取字符串，避免 substr() 按字节截取 utf-8 中文导致乱码；同时确保响应头、文件编码、函数调用一致性。

thinkphp截取字符串乱码转换如何规避

直接用 mb_substr()，别碰 substr() —— 这是规避 ThinkPHP 截取字符串乱码最简单、最可靠的做法。前提是你的 PHP 环境已启用 mbstring 扩展（绝大多数现代环境默认开启）。

为什么 ThinkPHP 里 `substr()` 一截中文就乱码

ThinkPHP 本身不干预字符串函数行为，乱码根源在 PHP 底层：substr() 按字节切，而 UTF-8 中文占 3 字节。比如截取位置落在某个中文的第 2 个字节上，结果就是半个字符，浏览器渲染即乱码。

常见错误现象：

前端显示、或一堆问号
截取后字符串末尾多出异常符号（如 … 前出现乱码）
同一段代码在 CLI 下正常，Web 下乱码（往往因响应头或模板编码未对齐）

这不是 ThinkPHP 的 Bug，是误用单字节函数处理多字节文本的必然结果。

btpanel phpsite 宝塔面板PHP网站

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

下载

`mb_substr()` 的正确调用姿势

必须显式传入编码参数，不能依赖内部默认值。ThinkPHP 项目几乎全是 UTF-8，所以固定写 'utf-8'：

// ✅ 正确：指定编码，按字符数截取
$short = mb_substr($title, 0, 15, 'utf-8');

// ❌ 错误：没指定编码，可能 fallback 到 latin1 或系统 locale
$short = mb_substr($title, 0, 15);

// ❌ 错误：用错函数，仍走字节逻辑
$short = substr($title, 0, 15);

注意事项：

mb_substr() 第四个参数必须是字符串，如 'utf-8'，不能写成 UTF8 或 UTF_8
若字符串实际是 GBK 编码（极少见），需改用 'gbk'，但务必确认来源一致
ThinkPHP 模板中慎用原生 PHP 函数，建议封装成助手函数或使用 Str::limit()（TP6+）

ThinkPHP 模板中输出截断的坑

即使 PHP 层用了 mb_substr()，模板里还可能翻车：

HTML 响应头没设 charset：header('Content-Type: text/html; charset=utf-8'); 必须存在（入口文件或中间件）
模板文件本身保存为 ANSI/GBK 编码，却当 UTF-8 解析 —— 用编辑器确认并转存为 UTF-8 无 BOM
直接在模板里写 <?php echo mb_substr($str, 0, 10); ?> 而没传编码，等于白做
TP6 的 {{ $str|str_limit:10 }} 默认用 mb_substr，但底层仍依赖环境编码设置，不可盲目信任

最易被忽略的一点：mb_strlen() 和 mb_substr() 必须配对使用。如果你先用 mb_strlen($s, 'utf-8') 判断长度，再用 substr() 截取，前面的判断就白算了 —— 字符数和字节数永远对不上。