ThinkPHP 6 无内置编码转换函数，必须使用 PHP 原生 mb_convert_encoding() 或 iconv()；推荐封装带 fallback 的工具函数，并在中间件中于框架解析前手动转码 GBK 请求体为 UTF-8。
ThinkPHP 6 里没有内置的字符串编码转换函数
ThinkPHP 6 完全移除了对 iconv 和 mb_convert_encoding 的封装，也不提供类似 TP5 的 think\helper\Str::encoding() 这类方法。你不能直接调用一个 ThinkPHP 自带的“编码转换函数”——它根本不存在。
实际开发中，必须依赖 PHP 原生扩展，且需自行判断环境是否支持：
-
mb_convert_encoding()更通用，推荐优先使用（需启用mbstring扩展） -
iconv()在部分旧系统上更稳定，但遇到非法字节会失败（可加//IGNORE或//TRANSLIT修饰符） - 若两者都不可用，只能手动查表或放弃转换（比如处理纯 ASCII 场景）
如何安全地在 TP6 中做 GBK ↔ UTF-8 转换
最常见需求是读取 GBK 编码的 CSV、Excel 模板或旧数据库字段，转成 UTF-8 后渲染或存入新库。别硬套框架逻辑，直接写工具函数即可：
function convert_encoding(string $str, string $to = 'UTF-8', string $from = 'GBK'): string
{
if (function_exists('mb_convert_encoding')) {
return mb_convert_encoding($str, $to, $from);
}
if (function_exists('iconv')) {
$result = @iconv($from, $to . '//IGNORE', $str);
return $result === false ? $str : $result;
}
throw new \RuntimeException('No encoding conversion function available');
}
注意点：
立即学习“PHP免费学习笔记（深入）”；
- 一定要用
@iconv抑制警告，否则非法字符会触发E_NOTICE -
//IGNORE会跳过无法转换的字节；//TRANSLIT会尝试音译（如 “é” → “e”），但对中文无效 - 不要在循环里反复调用
function_exists，可提前检测并缓存结果
为什么 Model 或 Request 输入自动转码不靠谱
TP6 的 Request 类默认按 UTF-8 解析请求体，如果前端发来 GBK 编码的 application/x-www-form-urlencoded 数据，框架不会自动识别或转换——它会把 GBK 字节流当 UTF-8 解码，结果就是乱码（如 “中文” 变成 “涓枃”）。
正确做法是：在中间件里拦截原始输入，手动转码后再交由框架处理：
public function handle($request, \Closure $next)
{
if ($request->isPost() && $request->contentType() === 'application/x-www-form-urlencoded') {
$raw = file_get_contents('php://input');
if (!empty($raw)) {
$utf8 = convert_encoding($raw, 'UTF-8', 'GBK');
parse_str($utf8, $data);
// 替换原始 POST 数据（需重设 $_POST 并清空原数据）
$_POST = array_merge($_POST, $data);
}
}
return $next($request);
}
这个方案有明显限制：
- 仅适用于表单提交，JSON 或 XML 需单独处理
- 不能覆盖所有编码（比如 GB2312、BIG5），必须明确知道来源编码
- 开启
always_populate_raw_post_data（已废弃）或依赖php://input，某些 CGI 环境下不可用
调试时怎么快速确认字符串当前编码
别猜。用 mb_detect_encoding() 不可靠（尤其对短字符串或纯 ASCII），应结合 mb_check_encoding() 多次验证：
$str = $_POST['title'] ?? '';
var_dump([
'is_utf8' => mb_check_encoding($str, 'UTF-8'),
'is_gbk' => mb_check_encoding($str, 'GBK'),
'is_ascii'=> mb_check_encoding($str, 'ASCII'),
]);
输出示例：
array(3) {
["is_utf8"]=>
bool(false)
["is_gbk"]=>
bool(true)
["is_ascii"]=>
bool(false)
}
这意味着该字符串极大概率是 GBK 编码，可放心传给 convert_encoding($str, 'UTF-8', 'GBK')。
真正麻烦的是混合编码或损坏字节流——这种情况下，任何自动转换都可能出错，得靠业务层约定或日志反查源头。
