PHP 7.4 字符串编码问题核心在于UTF-8不统一，需建立可验证的编码控制链：确保输入源（数据库、文件、$_GET/$_POST）为UTF-8，PHP内部用mb_internal_encoding('UTF-8')并显式指定mb_*函数编码参数，输出时设置响应头与HTML meta，并注意Windows路径及文件名编码转换。
PHP 7.4 字符串编码问题，核心在于 UTF-8 不统一——数据来源、PHP 内部处理、输出目标三者编码不一致，就会出现乱码、搜索失败、截断错误等现象。解决不是靠“试”，而是建立一套可验证的编码控制链。
确保所有输入源是 UTF-8
乱码往往从源头开始：
- 数据库连接必须设为 utf8mb4：PDO 连接时加 charset=utf8mb4；MySQLi 调用 set_charset('utf8mb4')
- 文件读取前先确认编码：若读的是 GBK 文件，用 mb_convert_encoding(file_get_contents($file), 'UTF-8', 'GBK') 转换，别依赖
mb_detect_encoding()（它不可靠） - $_GET/$_POST 中文参数：浏览器可能按系统编码（如 GBK）提交，需显式转码：mb_convert_encoding($_GET['q'], 'UTF-8', 'GBK')，或更稳妥地用 iconv('GBK', 'UTF-8//IGNORE', $_GET['q'])
强制 PHP 内部使用 UTF-8 处理
避免 mb_* 函数默认用错编码：
- 在脚本开头（或入口文件）调用：mb_internal_encoding('UTF-8')
- 检查 php.ini 是否已设：mbstring.internal_encoding = UTF-8（Debian/Ubuntu 下常在
/etc/php/7.4/fpm/php.ini） - 所有字符串操作改用 mb_ 系列函数，并**显式传入 'UTF-8' 参数**：
mb_strpos($text, $keyword, 0, 'UTF-8')
mb_substr($str, 0, 10, 'UTF-8')
mb_strlen($str, 'UTF-8')
输出与文件路径也要匹配 UTF-8
处理完字符串，输出环节同样关键：
立即学习“PHP免费学习笔记（深入）”；
- 网页响应头加：header('Content-Type: text/html; charset=UTF-8')
- HTML 中写：<meta charset="UTF-8">
- Windows 下写中文路径（如
file_put_contents('./用户/张三.txt', $data)）会失败：需转为 GBK：mb_convert_encoding('./用户/张三.txt', 'GBK', 'UTF-8') - 浏览器下载中文文件名：用 filename*=UTF-8''%E6%97%A5%E5%BF%97.txt 格式，不要只写
filename="日志.txt"
调试时看清真实编码状态
别猜，要验证：
- 用 var_dump(bin2hex($str)) 看原始字节（UTF-8 中文通常是
e4bda0这类三字节序列） - 用 mb_detect_encoding($str, ['UTF-8','GBK','BIG5'], true) 辅助判断（仅作参考，不用于生产逻辑）
- 宝塔面板中开启 display_errors = On 和 error_reporting = E_ALL，查看错误日志里是否有 “mb_strpos(): Encoding is not supported” 类提示
- 对关键变量，加一行：error_log("编码：" . mb_detect_encoding($str) . "，长度：" . mb_strlen($str, 'UTF-8'), 3, '/tmp/debug.log');
