php网站数据库中文乱码_mysqli连接字符集设置
解决PHP网站乱码的核心是「统一编码」——所有环节都用同一种编码(推荐UTF-8,支持所有语言和emoji的是utf8mb4)。本文提供一套完整的UTF-8编码配置方案:1.数据库:创建数据库时指定CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci,表和字段也用utf8mb4;已有数据库转换(ALTER DATABASE/TABLE CONVERT TO)。2.数据库连接:PHP连接后立即设置字符集——mysqli: mysqli_set_charset($conn,'utf8mb4'); PDO: new PDO('mysql:host=localhost;dbname=db;charset=utf8mb4',...); 旧版mysql: mysql_query('SET NAMES utf8mb4');。3.PHP文件:所有.php/.html/.css/.js文件保存为UTF-8无BOM编码(用VS Code/Notepad++,不要用记事本)。4.HTML:
中加(HTML5)或。5.PHP header:PHP输出前加header('Content-Type: text/html; charset=utf-8');(注意必须在任何输出前,否则报headers already sent)。6.服务器:Apache httpd.conf或.htaccess加AddDefaultCharset UTF-8;Nginx nginx.conf加charset utf-8;。7.编辑器:设置默认编码UTF-8无BOM。所有环节统一UTF-8/utf8mb4,乱码问题基本消除。PHP网站乱码完整解决方案(统一UTF-8)。一个PHP网站的编码涉及6个环节,全部统一为UTF-8(数据库用utf8mb4)就能解决99%的乱码。环节1:数据库字符集。a.创建新数据库时:CREATE DATABASE 库名 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; b.已有数据库转换:ALTER DATABASE 库名 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;(只改数据库默认,不改已有表)c.转换表:ALTER TABLE 表名 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;(转换表和所有字符字段,大表会锁表,低峰期操作,操作前备份)d.批量转换所有表:SELECT CONCAT('ALTER TABLE ', table_name, ' CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;') FROM information_schema.tables WHERE table_schema='库名'; 生成SQL批量执行。e.注意:utf8(MySQL的utf8最多3字节,不支持emoji和部分生僻字)→用utf8mb4(4字节,完整UTF-8)。环节2:数据库连接字符集(最关键,很多乱码是这里没设)。a.MySQLi:$conn = mysqli_connect(...); mysqli_set_charset($conn, 'utf8mb4');(必须在连接后立即设置,在查询前)b.PDO:$pdo = new PDO('mysql:host=localhost;dbname=库;charset=utf8mb4', '用户', '密码');(DSN中加charset=utf8mb4,PHP 5.3.6+支持)c.旧版mysql扩展(已废弃):mysql_connect(...); mysql_query('SET NAMES utf8mb4'); d.框架配置:ThinkPHP config/database.php中'charset'=>'utf8mb4';Laravel .env中DB_CHARSET=utf8mb4 DB_COLLATION=utf8mb4_unicode_ci;WordPress wp-config.php中define('DB_CHARSET','utf8mb4'); define('DB_COLLATE','utf8mb4_unicode_ci'); e.验证:执行SHOW VARIABLES LIKE 'character%'; 看character_set_client、character_set_connection、character_set_results都是utf8mb4。环节3:PHP源文件编码。a.所有.php/.html/.css/.js文件保存为UTF-8无BOM编码。b.编辑器设置:VS Code(右下角点编码→Save with Encoding→UTF-8,设置files.encoding为utf8);Notepad++(编码→转为UTF-8无BOM编码格式);Sublime Text(File→Save with Encoding→UTF-8)。c.绝对不要用Windows记事本编辑PHP文件(记事本默认UTF-8带BOM,会导致页面空白、session失效、headers already sent错误)。d.批量转换:用iconv命令(Linux)批量转换目录下文件:find . -name '*.php' -exec iconv -f GBK -t UTF-8 {} -o {} ;(注意备份,转换失败的文件单独处理);或用编辑器批量转换(Notepad++→宏→批量转换)。环节4:HTML页面编码声明。a.HTML5:
中第一行加(必须在head最前面,title之前)。b.HTML4/XHTML:。c.如果是纯文本/JSON/XML输出,也要设置对应编码。环节5:PHP HTTP响应头。a.在PHP输出任何内容前(最顶部,HTML之前)加:<?php header('Content-Type: text/html; charset=utf-8'); ?> b.注意:必须在任何输出之前(包括空格、换行、BOM),否则报「headers already sent」错误。c.如果已经有输出(如模板中),可以用输出缓冲:ob_start(); 在最顶部,最后ob_end_flush(); 或者在.htaccess/服务器配置默认编码。d.JSON输出:header('Content-Type: application/json; charset=utf-8'); echo json_encode($data, JSON_UNESCAPED_UNICODE);(JSON_UNESCAPED_UNICODE让中文不转义,PHP 5.4+)。环节6:服务器默认编码。a.Apache:httpd.conf中AddDefaultCharset UTF-8;或.htaccess中AddDefaultCharset UTF-8。b.Nginx:nginx.conf的http块或server块中charset utf-8;(默认off,设为utf-8会在响应头加charset)。c.IIS:web.config中PHP网站各服务器编码配置(Apache/Nginx/IIS)。服务器默认编码会在HTTP响应头加charset,如果服务器默认编码和页面编码不一致,可能导致浏览器用错误编码解析页面。Apache配置:a.全局配置(httpd.conf):AddDefaultCharset UTF-8(设置默认字符集为UTF-8,所有响应加charset=utf-8);或AddDefaultCharset Off(关闭,让页面自己声明)。b.虚拟主机配置(httpd-vhosts.conf):
PHP网站数据库乱码深度排查和修复。数据库乱码是最复杂的乱码问题,因为可能数据已经损坏。排查步骤:第一步:确认数据库中数据是否正常。用phpMyAdmin浏览文章表(如ay_content、dede_archives、wp_posts),看title、content字段的中文:a.如果phpMyAdmin中显示正常(中文正确)→数据存储正常,是读取/输出编码问题(连接字符集或页面编码),修复连接和输出编码即可。b.如果phpMyAdmin中显示乱码/问号→数据存储时就损坏了,需要修复数据(复杂)。第二步:检查数据库/表/字段字符集。a.phpMyAdmin→数据库→操作→排序规则(看数据库默认字符集)。b.表→操作→排序规则(看表字符集)。c.表→结构→看字符字段(varchar/text)的排序规则(collation)。d.都应该是utf8mb4_unicode_ci(或utf8_general_ci,但推荐utf8mb4)。e.如果是latin1、gbk、gb2312,需要转换。第三步:检查连接字符集。a.在PHP中连接后执行:$result = mysqli_query($conn, "SHOW VARIABLES LIKE 'character%'"); while($row=mysqli_fetch_assoc($result)){echo $row['Variable_name'].': '.$row['Value'].'
';} b.看character_set_client(客户端字符集)、character_set_connection(连接字符集)、character_set_results(结果集字符集),都应该是utf8mb4。c.如果是latin1或gbk,就是连接字符集没设,导致读写编码错误。第四步:修复连接字符集。a.MySQLi:mysqli_set_charset($conn, 'utf8mb4'); b.PDO:DSN加charset=utf8mb4。c.框架:配置文件charset设utf8mb4。d.修复后新数据正常,但已损坏的旧数据需要单独修复。第五步:修复已损坏的数据(根据损坏类型)。损坏类型1:连接用latin1写入utf8数据库(最常见,中文变成?或乱码)。现象:数据库中是问号?或乱码,数据信息已部分丢失。修复:a.如果是问号?→无法恢复(信息已丢失),重新录入或从备份恢复。b.如果是乱码(不是问号,如䏿–‡这种UTF-8字符被按latin1显示)→可能是双重编码,可以修复。方法:把字段内容按latin1读取再转utf8写入。SQL示例:UPDATE 表名 SET 字段名 = CONVERT(CAST(CONVERT(字段名 USING latin1) AS BINARY) USING utf8mb4); (这个SQL把latin1存储的utf8数据转回来,需要根据实际情况调整,操作前备份,先少量测试)。损坏类型2:GBK数据导入utf8数据库(或反之)。现象:中文完全乱码。修复:a.从正确编码的备份重新导入(最可靠)。b.如果没有备份,用PHP脚本读取每条数据,用mb_convert_encoding($data, 'UTF-8', 'GBK')转换后写回(需要知道原始编码,测试几条确认)。损坏类型3:utf8数据想转utf8mb4(支持emoji)。现象:emoji变成?或乱码,其他中文正常。修复:a.转换数据库/表为utf8mb4(ALTER TABLE CONVERT TO CHARACTER SET utf8mb4)。b.连接字符集设utf8mb4。c.已损坏的emoji数据无法恢复(变成?了),重新录入。d.注意索引长度问题(MySQL 5.7.7+默认支持,老版本需要调整)。损坏类型4:数据库正常但页面乱码(输出编码错)。修复:a.设连接字符集utf8mb4。b.PHP header设UTF-8。c.HTML meta设UTF-8。d.PHP文件UTF-8无BOM。数据修复注意事项:a.修复前务必备份整个数据库(mysqldump或phpMyAdmin导出)。b.先在少量数据上测试修复SQL/脚本,确认正确再批量执行。c.修复后验证数据(phpMyAdmin浏览、前台访问)。d.复杂的数据损坏(双重编码、多重转换)建议找专业人员,不要盲目执行SQL可能进一步损坏数据。e.修复后统一所有编码环节,防止新数据继续损坏。数据库乱码预防:1.创建数据库时就指定utf8mb4,不要用默认(很多MySQL默认latin1或utf8)。2.PHP连接后立即设字符集,不要依赖默认。3.迁移数据库时导出导入确认编码一致。4.定期检查数据库字符集配置。5.用utf8mb4不用utf8(支持emoji,完整UTF-8)。
用户真实体验:「页面顶部有空白,查了是模板文件有BOM头(用记事本改过),用Notepad++转UTF-8无BOM就好了,以后再也不用记事本改代码了」「emoji显示问号,查了数据库是utf8不支持,转成utf8mb4就好了,现在emoji正常显示」。
经验总结:PHP网站乱码90%是编码不统一,统一UTF-8/utf8mb4就解决。最常见的3个坑:1.数据库连接没设字符集(PHP连接后立即mysqli_set_charset/PDO charset);2.文件有BOM头(用记事本保存导致,转UTF-8无BOM);3.迁移数据库导入编码错误(导出导入确认UTF-8)。排查从外到内:浏览器手动切编码测试→F12看响应头charset→HTML meta声明→PHP文件编码(编辑器看)→数据库连接字符集(SHOW VARIABLES)→数据库数据是否正常(phpMyAdmin看)→数据库/表字符集。数据损坏分情况:问号无法恢复,乱码(双重编码)可用CONVERT修复,GBK/UTF8互导错误重新正确导入。预防:创建库就设utf8mb4、连接设字符集、文件统一UTF-8无BOM、团队编码规范、迁移确认编码。掌握这些,乱码问题迎刃而解。

更新时间:2026-08-27 11:44:35
上一篇:密码登录_网站后台账号错误解决