PHP PDO连接数据库防止中文乱码的两种配置方法

结果与目标

解决目标是确保PHP脚本与MySQL服务器之间的通信完全使用一致的字符集（通常为 utf8mb4 或 utf8），从而避免编码转换导致的乱码。实施上述任一方法后，向数据库插入的中文文本应能准确保存，且前端页面能够正常渲染。

准备条件

• 环境基础：已安装PHP及PDO MySQL扩展。
• 配置文件：项目源代码文件需保存为 UTF-8 编码（推荐无BOM头）。
• 常量定义：假设已定义好连接所需的数据源字符串 DB_DSN、用户名 DB_NAME 和密码 DB_PASS。
• 数据库端：确保数据库表及字段的字符集也支持中文（如 utf8mb4）。

真实操作顺序

第1步：在PDO实例化后立即设置字符集

目的：在获取到PDO对象句柄后，立即发送SQL指令修改当前会话的字符集设置。

入口/动作：调用PDO对象的 query() 或 exec() 方法执行 SET NAMES 语句。

重要参数：

• 推荐使用 utf8mb4 以支持完整的Unicode字符（包括emoji）；若仅兼容旧版MySQL可改用 utf8。

完整示例代码：

<?php
class DB {
    static public function getDB() {
        try {
            // 定义PDO选项：持久连接、异常模式
            $opts = array(
                PDO::ATTR_PERSISTENT => true,
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION // 建议设为2或直接使用常数
            );
            
            // 实例化PDO对象
            $pdo = new PDO(DB_DSN, DB_NAME, DB_PASS, $opts);
            
            // 关键步骤：设置会话字符集
            $pdo->query('SET NAMES utf8mb4');
            // 或者使用: $pdo->exec('SET NAMES utf8mb4');
            
            return $pdo;
        } catch (PDOException $e) {
            exit('数据库连接错误！错误信息：' . $e->getMessage());
        }
    }
}
?>

完成状态：后续所有通过此 $pdo 对象进行的查询操作，都将默认使用设置的字符集进行数据传输。

第2步：在PDO构造函数的DSE中指定初始化命令

目的：将字符集设置作为连接建立的一部分自动执行，减少冗余代码调用。

入口/动作：在PDO构造函数 new PDO(...) 的第四个参数数组中，添加 PDO::MYSQL_ATTR_INIT_COMMAND 键值对。

重要参数：

• 键名：PDO::MYSQL_ATTR_INIT_COMMAND
• 值：'SET NAMES utf8mb4'

完整示例代码：

<?php
class DB {
    static public function getDB() {
        try {
            // 定义PDO选项，包含初始化命令
            $opts = array(
                PDO::ATTR_PERSISTENT => true,
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
                // 核心配置：在连接时自动执行SET NAMES
                PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8mb4'
            );
            
            // 实例化PDO对象
            $pdo = new PDO(DB_DSN, DB_NAME, DB_PASS, $opts);
            
            // 无需再额外调用 query 或 exec
            return $pdo;
        } catch (PDOException $e) {
            exit('数据库连接错误！错误信息：' . $e->getMessage());
        }
    }
}
?>

完成状态：每次创建新的PDO连接时，MySQL服务器都会预先执行一次字符集设置命令，从根本上防止乱码产生。

原文有依据的排错

• 确认文件编码：如果配置了正确的字符集仍乱码，请先检查IDE或编辑器是否将PHP文件保存为了GBK或其他编码，文件必须与代码中声明的字符集一致。
• 区分版本差异：对于非常旧的PHP版本（如PHP 5.3之前），可能需要直接使用Pdo::MYSQL_ATTR_INIT_COMMAND全大写路径，但现代开发中建议使用常量形式以提高可读性。
• 优先级注意：如果同时使用了第一种和第二种方法，通常以实际执行的最后一次为准，但推荐统一使用第二种方案以保持代码简洁。

简要总结

PHP PDO连接MySQL时的中文乱码问题，本质上是连接层字符集未对齐所致。通过在实例化后执行 SET NAMES 或在PDO配置中添加 PDO::MYSQL_ATTR_INIT_COMMAND，可以高效地修正这一行为。建议在项目中统一采用 utf8mb4 编码标准，并优先使用构造函数参数的方式初始化，以获得更稳定的数据库交互体验。

以上就是PHP使用PDO操作数据库的乱码问题解决方法，更多关于PHP数据库编程的资料请关注本站其它相关文章！