本文旨在解决PHP连接MariaDB数据库时，由于编码问题导致数据插入失败的问题。通过分析常见的错误原因，如字符编码不一致，以及提供详细的排查和解决方案，帮助开发者确保数据在PHP、数据库和客户端之间正确传输和存储，避免出现“Incorrect string value”等错误。本文重点以连字符(`–`)为例，提供具体代码示例，帮助读者理解和应用。
问题描述
在使用PHP连接MariaDB数据库时，可能会遇到“Incorrect string value”的错误，尤其是在处理包含特殊字符（如连字符–）的字符串时。即使数据库和客户端都配置了utf8mb4编码，通过HeidiSQL等工具手动执行SQL语句可以成功，但通过PHP执行却会报错。
原因分析
这种问题的根本原因通常是字符编码不一致。具体来说，可能存在以下几种情况：
- 数据源编码问题： 从外部数据源（如Gmail邮件）获取的数据可能使用非UTF-8编码，例如Windows代码页（如cp1252）。
- PHP编码处理不当： PHP在处理字符串时，如果没有正确地进行编码转换，可能会导致字符编码混乱。
- 连接编码设置问题： PHP连接MariaDB时，如果没有明确指定连接编码，可能会使用默认编码，导致数据传输过程中出现编码错误。
解决方案
解决此类问题的关键在于确保数据在整个流程中都使用一致的UTF-8编码。以下是详细的步骤和代码示例：
立即学习“PHP免费学习笔记（深入）”；
-
确定数据源编码：
首先，需要确定数据源的实际编码。可以使用mb_detect_encoding()函数来尝试检测编码：
$header = "Subject: orkut – convite..."; // 假设从邮件头获取的字符串 $encoding = mb_detect_encoding($header); echo "Detected encoding: " . $encoding . "\n";
如果mb_detect_encoding()无法正确检测，或者已知数据源使用了特定的Windows代码页（例如cp1252），则可以直接指定编码进行转换。
-
将数据转换为UTF-8编码：
使用mb_convert_encoding()函数将数据转换为UTF-8编码。如果确定数据源使用了cp1252编码，可以使用以下代码：
$header = "Subject: orkut – convite..."; // 假设从邮件头获取的字符串 $utf8_header = mb_convert_encoding($header, 'UTF-8', 'cp1252'); echo "UTF-8 encoded header: " . $utf8_header . "\n";
如果数据源编码未知，可以尝试使用mb_detect_encoding()检测到的编码进行转换：
$header = "Subject: orkut – convite..."; // 假设从邮件头获取的字符串 $encoding = mb_detect_encoding($header); if ($encoding) { $utf8_header = mb_convert_encoding($header, 'UTF-8', $encoding); echo "UTF-8 encoded header: " . $utf8_header . "\n"; } else { echo "Unable to detect encoding.\n"; } -
设置数据库连接编码：
在PHP连接MariaDB时，务必设置连接编码为utf8mb4。可以使用以下方法：
-
使用mysqli扩展：
$mysqli = new mysqli("localhost", "user", "password", "database"); if ($mysqli->connect_errno) { echo "Failed to connect to MySQL: " . $mysqli->connect_error; exit(); } if (!$mysqli->set_charset("utf8mb4")) { echo "Error setting character set utf8mb4: " . $mysqli->error; exit(); } // 使用预处理语句 $stmt = $mysqli->prepare("INSERT INTO mail (subject) VALUES (?)"); $stmt->bind_param("s", $utf8_header); $stmt->execute(); $stmt->close(); $mysqli->close(); -
使用PDO扩展：
$dsn = "mysql:host=localhost;dbname=database;charset=utf8mb4"; $options = [ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, PDO::ATTR_EMULATE_PREPARES => false, ]; try { $pdo = new PDO($dsn, "user", "password", $options); } catch (\PDOException $e) { throw new \PDOException($e->getMessage(), (int)$e->getCode()); } // 使用预处理语句 $stmt = $pdo->prepare("INSERT INTO mail (subject) VALUES (?)"); $stmt->execute([$utf8_header]);
注意： 强烈建议使用预处理语句来执行SQL查询，以防止SQL注入攻击，并确保数据类型正确处理。
-
-
数据库和表编码设置：
确保数据库和表的编码都设置为utf8mb4，排序规则设置为utf8mb4_unicode_520_ci。可以使用以下SQL语句进行设置：
ALTER DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci; ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;
总结
解决PHP连接MariaDB时出现的编码问题，需要从数据源、PHP编码处理和数据库连接三个方面入手，确保数据在整个流程中都使用一致的UTF-8编码。通过正确地使用mb_convert_encoding()函数进行编码转换，并设置数据库连接编码为utf8mb4，可以有效地避免“Incorrect string value”等错误。同时，使用预处理语句可以提高代码的安全性和可维护性。
