PHP项目中文乱码及本地化失败的解决步骤为：一、统一PHP默认字符集为UTF-8；二、启用并验证intl与gettext扩展；三、强制HTTP响应头声明UTF-8；四、数据库连接层使用utf8mb4编码；五、配置系统级locale。
如果您在部署PHP项目时遇到中文显示为问号、小方块或英文混杂乱码，或是语言切换后文本未正确本地化，则很可能是服务器端字符集配置缺失或多语言环境未就绪。以下是解决此问题的步骤：
一、统一PHP默认字符集为UTF-8
确保PHP内部输出始终以UTF-8编码解析，是防止乱码的基础前提。该设置影响header()、htmlentities()及所有未显式指定编码的字符串处理函数。
1、执行命令php --ini定位当前生效的php.ini路径。
2、用文本编辑器打开php.ini文件，搜索default_charset配置项。
立即学习“PHP免费学习笔记（深入）”；
3、将其值设为"UTF-8"，若该行被分号注释则需删除分号启用。
4、保存后重启Web服务器（Apache执行sudo systemctl restart apache2，Nginx+PHP-FPM执行sudo systemctl restart php-fpm nginx）。
二、启用并验证intl与gettext扩展
intl扩展提供符合Unicode标准的本地化能力，支持MessageFormatter、NumberFormatter等；gettext扩展则用于标准PO/MO翻译流程。二者不可相互替代，需按需启用。
1、检查phpinfo()输出页面中是否存在intl和gettext模块区块。
2、若缺失，在Ubuntu/Debian系统执行sudo apt-get install php-intl php-gettext；在CentOS/RHEL执行sudo yum install php-intl php-gettext或dnf install php-intl php-gettext。
3、确认php.ini中已取消注释对应扩展行：extension=intl和extension=gettext。
4、再次重启PHP服务使扩展加载生效。
三、强制HTTP响应头声明UTF-8字符集
即使PHP内部使用UTF-8，若HTTP响应头未明确声明charset，浏览器可能依据历史缓存或自动探测机制错误解码，导致前端乱码。
1、在所有PHP入口脚本（如index.php）顶部、任何输出之前插入：header('Content-Type: text/html; charset=UTF-8');
2、确保该语句前无空格、BOM、echo、print或HTML内容，否则触发“headers already sent”错误。
3、作为补充，在Apache配置中添加AddDefaultCharset UTF-8至虚拟主机或.htaccess；在Nginx中于server块内加入charset utf-8;。
四、配置数据库连接层使用utf8mb4编码
MySQL的utf8实际为utf8mb3，无法存储emoji及部分生僻汉字；必须升级为utf8mb4并同步配置连接层，否则从数据库读出的数据在PHP中仍会截断或转为问号。
1、修改MySQL配置文件my.cnf，在[client]、[mysql]、[mysqld]段分别添加：default-character-set = utf8mb4与collation-server = utf8mb4_unicode_ci。
2、重启MySQL服务。
3、对现有数据库及表执行SQL：ALTER DATABASE your_db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;与ALTER TABLE your_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;。
4、PHP连接时显式设置：MySQLi方式调用$mysqli->set_charset("utf8mb4")；PDO方式在DSN中追加;charset=utf8mb4，例如mysql:host=localhost;dbname=test;charset=utf8mb4。
五、设置系统级locale并验证可用性
gettext与setlocale依赖操作系统预装的locale定义。若setlocale(LC_ALL, 'zh_CN.UTF-8')返回false，说明系统未生成该locale，后续翻译加载必然失败。
1、执行locale -a | grep zh_CN检查是否已存在zh_CN.utf8或zh_CN.UTF-8。
2、若无结果，在Ubuntu/Debian执行：sudo locale-gen zh_CN.UTF-8；在CentOS/RHEL编辑/etc/locale.conf写入LANG="zh_CN.UTF-8"后执行sudo localedef -c -i zh_CN -f UTF-8 zh_CN.UTF-8。
3、执行sudo update-locale（Debian系）或localectl set-locale LANG=zh_CN.UTF-8（systemd系）使全局生效。
4、在PHP中测试：var_dump(setlocale(LC_ALL, 'zh_CN.UTF-8'));应返回string(13) "zh_CN.UTF-8"而非false。
