本文旨在解决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”等错误。同时，使用预处理语句可以提高代码的安全性和可维护性。
以上就是解决PHP连接MariaDB时出现的编码问题：以连字符为例的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1323479.html
微信扫一扫 
支付宝扫一扫 
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254039529565.jpg)
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254039878675.jpg)
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254039840102.jpg)
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254040055572.jpg)
