PHP连接MariaDB乱码解决方法

PHP连接MariaDB数据库时，经常会遇到字符集问题导致的乱码和数据存储异常。本文针对这一常见问题，提供了全面的解决方案，重点在于统一各环节的字符集为utf8mb4。首先，在创建或修改数据库和表时，务必指定utf8mb4字符集。其次，配置MariaDB服务器的默认字符集为utf8mb4，确保新连接使用正确的字符集。此外，在PHP连接数据库时，无论是使用mysqli还是PDO，都要明确设置字符集为utf8mb4。最后，页面输出时声明utf-8编码，保证前端显示正常。通过以上步骤，确保数据库、连接、脚本及前端编码一致，有效避免PHP与MariaDB交互中的乱码问题。

要解决PHP与MariaDB交互时的字符集问题，需统一各环节字符集为utf8mb4。1. 创建或修改数据库和表时指定utf8mb4；2. 配置MariaDB服务器默认字符集为utf8mb4；3. PHP连接时使用mysqli或PDO明确设置字符集；4. 页面输出时声明utf-8编码。以上步骤确保数据库、连接、脚本及前端一致使用utf8mb4，从而避免乱码和存储异常。

在PHP与MariaDB交互时，字符集问题常常会导致中文乱码、数据存储异常等现象。解决这类问题的关键在于统一各环节的字符集设置，包括数据库、表、字段、连接以及PHP脚本本身。

设置数据库和表的字符集

创建数据库和表的时候，要明确指定默认字符集为 utf8mb4，这是支持表情符号和其他特殊字符的完整解决方案。

CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE TABLE users (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(100)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

如果已有数据库或表，可以通过 ALTER 命令修改字符集：

• 修改数据库字符集：

  

  ALTER DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

• 修改表字符集：

  ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

配置MariaDB服务器默认字符集

光改数据库和表还不够，还要确保MariaDB服务器默认使用的是 utf8mb4。可以编辑 MariaDB 的配置文件（通常是 /etc/my.cnf 或 /etc/mysql/my.cnf），添加以下内容：

[client]
default-character-set = utf8mb4

[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

重启 MariaDB 后生效。这样就能保证新连接进来默认就是正确的字符集。

PHP连接时指定字符集

PHP连接MariaDB的方式有很多种，比如 mysqli 和 PDO。无论哪种方式，都要在连接成功后立即设置字符集。

使用 mysqli：

$mysqli = new mysqli("localhost", "user", "password", "mydb");
$mysqli->set_charset("utf8mb4");

使用 PDO：

$dsn = "mysql:host=localhost;dbname=mydb;charset=utf8mb4";
$opt = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
];
$pdo = new PDO($dsn, 'user', 'password', $opt);

注意：PDO 中不能只靠 DSN 中的 charset 来完全解决问题，建议再配合执行一次 SET NAMES 'utf8mb4' 查询。

页面输出也要统一编码

最后别忘了网页本身的编码。PHP 输出页面时，最好在响应头中加上字符集声明：

header('Content-Type: text/html; charset=utf-8');

同时 HTML 页面里也加上 meta 标签：

<meta charset="UTF-8">

这一步虽然不直接影响数据库操作，但能避免前端显示时出现乱码。

基本上就这些。只要数据库、连接、PHP脚本和前端都统一用 utf8mb4，大多数字符集问题都能迎刃而解。关键是在一开始就把各个环节都设对，后期排查起来才不会头疼。

好了，本文到此结束，带大家了解了《PHP连接MariaDB乱码解决方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！