ThinkPHP控制器字符转换公共函数编写-php教程-PHP中文网

thinkphp 6+需手动检测并转换gbk/gb2312等非utf-8请求参数，应在控制器基类中封装convertstrencoding方法，用mb_detect_encoding指定候选编码并开启strict模式，再调用mb_convert_encoding转为utf-8，且仅处理字符串类型并跳过已为utf-8的内容。

thinkphp控制器字符转换公共函数编写

ThinkPHP控制器里怎么统一处理中文字符编码？

直接说结论：ThinkPHP 6+ 默认使用 UTF-8，但若接收的请求含 GBK/GB2312 编码参数（比如老系统对接、部分硬件设备 POST 数据），input() 或 $request->param() 会读成乱码，不能靠框架自动转。必须手动检测并转换，且要放在控制器基类或中间件中统一做，不能每个方法都写一遍。

为什么不能只用 iconv 或 mb_convert_encoding 硬转？

因为不知道原始编码——用户提交的数据可能来自 Windows 记事本（GBK）、Linux 终端（UTF-8）、iOS 表单（UTF-8）甚至嵌入式设备（GB2312）。硬设 iconv('GBK', 'UTF-8', $str) 遇到本来就是 UTF-8 的内容会崩出 Notice: iconv(): Detected an illegal character；而 mb_convert_encoding($str, 'UTF-8', 'auto') 的 'auto' 实际不靠谱，对纯 ASCII 或短中文识别率极低。

实操建议：

优先用 mb_detect_encoding($str, ['UTF-8', 'GBK', 'GB2312'], true) 显式指定候选集，并开启 strict 模式（第三个参数为 true）
若检测结果为 false，说明可能是二进制或全 ASCII，可跳过转换
检测出编码后，再用 mb_convert_encoding($str, 'UTF-8', $detected) 转，避免损毁
注意：PHP 的 mbstring.func_overload 若开启，会影响 strlen 等行为，建议关闭，统一用 mb_* 系列

如何在控制器基类中封装可复用的转换方法？

不要写在每个控制器里，应在 app/controller/Controller.php（基类）中加一个公共方法，供子类调用。注意两点：一是只对字符串类型字段处理，二是避免重复转换（比如已确认是 UTF-8 的值不再动）。

示例代码（放在基类中）：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

protected function convertStrEncoding($value)
{
    if (!is_string($value) || mb_check_encoding($value, 'UTF-8')) {
        return $value;
    }
    $encoding = mb_detect_encoding($value, ['UTF-8', 'GBK', 'GB2312'], true);
    if ($encoding === false || $encoding === 'UTF-8') {
        return $value;
    }
    return mb_convert_encoding($value, 'UTF-8', $encoding);
}

子控制器中这样用：

public function index()
{
    $data = $this->request->param();
    array_walk_recursive($data, [$this, 'convertStrEncoding']);
    // 后续业务逻辑用 $data，所有字符串已确保为 UTF-8
}

POST 表单和 URL 参数要分开处理吗？

要。URL 参数（$_GET）通常由浏览器自动编码为 UTF-8，但某些国产浏览器或旧版 IE 可能发 GBK；POST 表单（$_POST）更不可信——尤其表单没设 accept-charset="UTF-8" 时，IE 默认用系统编码（Windows 简体即 GBK）。所以 $this->request->param() 返回的数组需整体递归处理，而 $this->request->get() 和 $this->request->post() 可按需单独调用转换。

容易踩的坑：