phpEnv 不管理 PHP 源码编码,乱码需从文件(UTF-8 无 BOM)、HTTP 响应(header 设置 charset)、MySQL 连接(utf8mb4)、PHP 内部(mbstring 启用并设 UTF-8)四层手动对齐。

phpEnv 本身不管理 PHP 源码编码,乱码根源在编辑器保存方式和运行时环境配置,不是 phpEnv 能“设置”出来的。 它只是 Windows 下的 PHP 集成环境(含 Apache、MySQL、PHP),字符集问题必须从文件、HTTP 响应、数据库、扩展四层手动对齐。
PHP 文件必须存为 UTF-8 无 BOM
这是最常被忽略的第一环。phpEnv 自带的 PHP 解析器对 BOM 极其敏感 —— 只要文件开头有 \xEF\xBB\xBF,哪怕只多一个空格,session_start()、header() 全部失效,后续所有 charset=utf-8 都白设。
- 用 VS Code 打开 .php 文件 → 右下角点击编码名(如“UTF-8”)→ 选“Save with Encoding” → “UTF-8”(不是 “UTF-8 with BOM”)
- Notepad++:编码 → 转为 UTF-8 无 BOM 格式 → 保存
- 禁止用系统记事本直接编辑或另存 PHP 文件,它默认加 BOM 且无法关闭
PHP 运行时必须显式发送 UTF-8 header
phpEnv 默认不自动设置输出编码,靠 PHP 脚本自己控制。仅靠 <meta charset="utf-8"> 不够,浏览器可能已按服务器默认(ISO-8859-1)解码完再渲染。
-
header('Content-Type: text/html; charset=utf-8');必须放在脚本最顶部,前面不能有任何输出(包括空行、空格、BOM) - 若用
require或include引入其他文件,确保被引入文件也满足 UTF-8 无 BOM + 无前置输出 - 检查 php.ini 中
default_charset = "utf-8"是否启用(phpEnv 通常已设,但建议确认)
MySQL 连接层必须强制 utf8mb4
phpEnv 自带的 MySQL 默认字符集通常是 latin1,连上就乱,跟表里存的啥编码无关。
立即学习“PHP免费学习笔记(深入)”;
- 连接后立即执行:
mysqli_set_charset($conn, 'utf8mb4'); - 或 PDO DSN 中硬编码:
mysql:host=127.0.0.1;dbname=test;charset=utf8mb4 - 别用
SET NAMES utf8—— MySQL 的utf8实为utf8mb3,不支持 emoji 和部分生僻中文 - 用 phpMyAdmin 或命令行执行
SHOW VARIABLES LIKE 'character_set%';确认 client/connection/result 都是utf8mb4
mbstring 扩展必须启用且设内部编码
phpEnv 默认可能未启用 mbstring,导致 strlen()、substr() 等函数按字节切中文,显示截断或乱码。
- 打开 php.ini,取消注释:
extension=mbstring - 添加或确认:
mbstring.internal_encoding = UTF-8 - 代码中可加:
mb_internal_encoding('UTF-8');(但 ini 设置更可靠) - 处理用户输入时,优先用
mb_convert_encoding($str, 'UTF-8', 'auto')替代iconv(),它能自动探测源编码
真正卡住人的永远不是某一行代码,而是四层编码(文件保存、HTTP 响应、MySQL 连接、PHP 内部处理)中任意一层掉链子 —— 尤其是 BOM 和 default_charset 这两个静默开关,不报错,只默默让中文变问号或方块。



















