PHP本地环境默认字符集需多层协同设定:php.ini中设default_charset、mbstring.language和mbstring.internal_encoding;Web服务器配置清除冲突的AddDefaultCharset或charset指令;脚本中显式声明meta charset、PDO连接用utf8mb4、文件保存为UTF-8无BOM。
PHP本地环境的默认字符集不是靠单个配置项“一键设定”,而是由多个层级共同决定:PHP自身、Web服务器(如Apache/Nginx)、数据库连接、以及脚本内显式声明。漏掉任一环,UTF-8就可能在某个环节退化成ISO-8859-1或乱码。
修改php.ini是基础,但只改default_charset不够。以下三项需同步确认:
default_charset = "UTF-8" —— 控制header("Content-Type")默认值和mbstring函数族的默认编码
mbstring.language = "Neutral" —— 避免语言区域干扰编码推断mbstring.internal_encoding = "UTF-8" —— 影响mb_strlen()等函数的行为(注意:PHP 8.2+已废弃此指令,改用mb_internal_encoding("UTF-8")在代码中显式调用)改完必须重启PHP服务(如sudo systemctl restart php-fpm或重启Apache),仅重载Web服务器不生效。
即使php.ini设了UTF-8,Web服务器若在全局或虚拟主机配置里硬写AddDefaultCharset ISO-8859-1或charset GBK,就会覆盖PHP输出。检查并清理这些配置:
httpd.conf或apache2.conf中搜索AddDefaultCharset,删掉或改为AddDefaultCharset UTF-8
nginx.conf或站点配置中检查charset指令,确保为charset utf-8;(注意分号),且不在location块中被重复覆盖特别注意:Nginx的charset默认不继承,子location需单独声明;Apache的.htaccess也可能含AddDefaultCharset,需一并排查。
本地环境再规范,单个脚本仍可能因疏忽导致乱码。以下操作必须显式执行:
,且必须位于最前$pdo = new PDO('mysql:host
=localhost;dbname=test;charset=utf8mb4', $user, $pass);(注意是utf8mb4,不是utf8)mysql_*()函数(已废弃),其不支持set names安全传递var_dump(mb_http_output());应返回"UTF-8";var_dump(mb_internal_encoding());在PHP 8.2+应手动设为"UTF-8"
文件本身也得是UTF-8无BOM格式——编辑器保存时选错编码,所有配置都白搭。