PHP源文件编码需靠BOM或编辑器设置,解析器只按字节流处理;PHP7/8中default_charset行为一致,但mbstring.internal_encoding默认值不同,PHP8强制显式设置且已废弃ini配置,json_encode()在PHP8中对非UTF-8输入更严格并直接报错。

PHP脚本文件本身的编码声明要靠BOM或编辑器设置,不是靠PHP代码
PHP解析器本身不读取UTF-8、GBK这类编码声明——它只按字节流解析文件。所谓“加编码”,实际分两层:一是源文件保存时的字符编码,二是运行时对字符串、输出、数据库等环节的编码控制。
常见错误是以为写个header('Content-Type: text/html; charset=utf-8');就能让整个PHP文件变UTF-8,结果中文注释乱码、json_encode()报错、甚至mb_strlen()计算出错——根源往往在文件保存编码不对(比如用ANSI存了含中文的PHP文件)。
- 用VS Code、PhpStorm等现代编辑器时,务必右下角确认显示为
UTF-8(无BOM更稳妥) - 避免用Windows记事本保存PHP文件,它默认ANSI/GBK且无法显式选UTF-8无BOM
- Linux/macOS下用
file -i your.php检查真实编码;Windows可用xxd your.php | head看前几个字节是否含BOM(ef bb bf)
PHP7与PHP8中default_charset行为一致,但mbstring默认值不同
default_charset只影响header()输出和htmlentities()等函数的默认目标编码,不影响源码解析或mb_*()系列函数的行为。PHP7和PHP8对此配置的处理逻辑完全相同。
真正有差异的是mbstring扩展的默认行为:
立即学习“PHP免费学习笔记(深入)”;
- PHP7.4及更早:若未设置
mbstring.internal_encoding,mb_*()函数会退回到ISO-8859-1,导致mb_strlen("中文")返回6(按单字节算)而非2 - PHP8.0+:强制要求
mbstring.internal_encoding必须显式设置,否则mb_*()函数会触发E_WARNING并返回false(如mb_strlen()) - PHP8.2起,
mbstring.internal_encoding已被废弃,改用mb_internal_encoding()函数调用设置,且不推荐依赖ini配置
所以PHP8里不能只靠php.ini写mbstring.internal_encoding = UTF-8就完事,必须在代码开头主动调用:
mb_internal_encoding('UTF-8');
json_encode()在PHP7与PHP8对非UTF-8字符串的处理更严格
json_encode()始终要求输入字符串是UTF-8编码。PHP7会尝试静默转换(如把GBK字符串当Latin1转UTF-8),结果不可靠;PHP8直接拒绝并返回false,同时触发json_last_error()为JSON_ERROR_UTF8。
典型踩坑场景:
- 从旧数据库(如GBK编码的MySQL表)直接查出数据,未经转换就
json_encode() - 接收
$_GET或$_POST参数(浏览器可能以GBK提交),没做mb_convert_encoding()就进JSON - PHP8中
iconv('GBK', 'UTF-8//IGNORE', $str)比mb_convert_encoding($str, 'UTF-8', 'GBK')更容错,建议优先用iconv
安全写法(PHP7/8通用):
$utf8_str = iconv('UTF-8', 'UTF-8//IGNORE', $input); // 先标准化输入
if ($utf8_str === false) {
$utf8_str = iconv('GBK', 'UTF-8//IGNORE', $input);
}
$json = json_encode($utf8_str);
输出到浏览器时,header() + mb_http_output()缺一不可
仅设header('Content-Type: text/html; charset=utf-8');不够。如果后续用mb_ereg_replace()或mb_substr()处理字符串,而mb_http_output()没设成UTF-8,某些mb_*()函数内部可能按错误编码做HTTP头拼接(尤其在CLI SAPI下易被忽略)。
- PHP7:不设
mb_http_output()时,mb_output_handler()可能按ISO-8859-1转义 - PHP8:该函数已废弃,但
mb_http_output()仍需显式调用,否则mb_send_mail()等函数可能出错 - 最佳实践:在脚本最开头统一设好
mb_internal_encoding('UTF-8');
mb_http_output('UTF-8');
header('Content-Type: text/html; charset=utf-8');
注意:如果用了ob_start('mb_output_handler'),必须确保mb_internal_encoding()已在之前调用,否则handler初始化失败。











