在开发web应用时，我们经常需要将图像、文档等二进制文件直接存储到数据库中，通常使用blob（binary large object）数据类型。然而，在使用php的mysqli扩展进行操作时，有时会遇到一个棘手的问题：所有文本或数字类型的数据都能成功写入数据库，唯独blob字段的数据为空或写入失败，即使代码逻辑看起来正确，file_get_contents()函数也已成功读取了文件内容，且数据库字段类型（如mediumblob）足以容纳文件大小，并且没有任何错误或警告信息。
这种情况通常发生在尝试通过预处理语句（prepared statements）的bind_param方法将二进制数据绑定为参数时。问题的根源往往在于MySQL服务器的max_allowed_packet配置限制，或者PHP/MySQLi处理大尺寸二进制数据的方式。当二进制数据量超过max_allowed_packet时，bind_param可能无法一次性处理，导致数据写入失败。
对于可能超出MySQL max_allowed_packet限制的大尺寸BLOB数据，mysqli_stmt_send_long_data()方法是官方推荐的解决方案。它允许分批发送二进制数据到数据库，从而规避了单次数据包大小的限制。
工作原理： 在使用bind_param绑定参数时，对于BLOB类型数据，应将其类型标识符设置为'b'。此时，bind_param并不会直接将完整数据绑定到参数，而是通知MySQLi该参数将接收二进制大对象。随后，通过mysqli_stmt_send_long_data()方法，将实际的二进制数据以流的形式发送给数据库。在send_long_data调用之前，通常会将绑定的变量初始化为NULL。
示例代码：
<?php
// 假设 $conn 已经是一个有效的 MySQLi 数据库连接对象
if (isset($_POST['file_one_submit'])) {
$post_input_name = 'file_one_input'; // HTML表单中文件输入字段的name属性
// 假设需要更新的记录ID，这里简化为1
$id = 1;
$file_content = NULL; // 初始将文件内容变量设为NULL，实际数据通过send_long_data发送
// 准备 REPLACE INTO 语句，用于插入或更新数据
// 注意：这里的 'b' 表示二进制大对象类型
$stmt = $conn->prepare("REPLACE INTO `images` (id, file) VALUES(?, ?);");
if ($stmt === false) {
die('Prepare failed: ' . htmlspecialchars($conn->error));
}
// 绑定参数：'i' 表示整数，'b' 表示二进制大对象
$stmt->bind_param("ib", $id, $file_content);
// 使用 send_long_data 发送实际的二进制数据
// 第一个参数是参数的索引（从0开始），第二个参数是实际的二进制数据
// file_get_contents() 用于读取上传文件的临时内容
$stmt->send_long_data(1, file_get_contents($_FILES[$post_input_name]['tmp_name']));
// 执行语句
if ($stmt->execute()) {
echo "文件上传并写入数据库成功！";
} else {
echo "文件写入数据库失败: " . htmlspecialchars($stmt->error);
}
$stmt->close();
}
?>
<!-- HTML 表单用于文件上传 -->
<form action="file.php" method="post" enctype="multipart/form-data">
<input type="file" name="file_one_input" />
<input type="submit" name="file_one_submit" value="上传文件" />
</form>注意事项：
立即学习“PHP免费学习笔记（深入）”；
在某些情况下，如果BLOB数据的大小并未超过max_allowed_packet限制，或者MySQL服务器和客户端的配置允许较大的数据包传输，将bind_param中的类型标识符从'b'改为's'（字符串）也能奏效。这是因为PHP在内部处理字符串时，会尝试将二进制数据作为普通字符串发送。
工作原理： 当使用's'类型绑定二进制数据时，PHP会将file_get_contents()读取到的二进制字符串作为一个完整的字符串参数发送给MySQL。如果这个字符串的长度在max_allowed_packet允许的范围内，并且数据库字段是BLOB类型，MySQL通常能够正确地接收和存储它。
示例代码：
<?php
// 假设 $conn 已经是一个有效的 MySQLi 数据库连接对象
if (isset($_POST['file_one_submit'])) {
$post_input_name = 'file_one_input'; // HTML表单中文件输入字段的name属性
// 假设需要更新的记录ID，这里简化为1
$id = 1;
// 直接读取文件内容
$file_content = file_get_contents($_FILES[$post_input_name]['tmp_name']);
// 准备 REPLACE INTO 语句
// 注意：这里的 's' 表示字符串类型
$stmt = $conn->prepare("REPLACE INTO `images` (id, file) VALUES(?, ?);");
if ($stmt === false) {
die('Prepare failed: ' . htmlspecialchars($conn->error));
}
// 绑定参数：'i' 表示整数，'s' 表示字符串
$stmt->bind_param("is", $id, $file_content);
// 执行语句
if ($stmt->execute()) {
echo "文件上传并写入数据库成功！";
} else {
echo "文件写入数据库失败: " . htmlspecialchars($stmt->error);
}
$stmt->close();
}
?>
<!-- HTML 表单用于文件上传 -->
<form action="file.php" method="post" enctype="multipart/form-data">
<input type="file" name="file_one_input" />
<input type="submit" name="file_one_submit" value="上传文件" />
</form>注意事项：
立即学习“PHP免费学习笔记（深入）”；
[mysqld] max_allowed_packet = 64M ; 根据需要设置，例如64MB
修改后需要重启MySQL服务。
upload_max_filesize = 64M post_max_size = 64M
修改后需要重启Web服务器（如Apache/Nginx）。
<form action="your_script.php" method="post" enctype="multipart/form-data">
<!-- ... -->
</form>if ($stmt === false) {
die('Prepare failed: ' . htmlspecialchars($conn->error));
}
// ...
if (!$stmt->execute()) {
echo "Error: " . htmlspecialchars($stmt->error);
}当PHP/MySQLi在写入BLOB数据时遇到困难，尤其是在没有明显错误提示的情况下，通常需要考虑max_allowed_packet限制以及PHP处理二进制数据的方式。对于大尺寸BLOB数据，推荐使用mysqli_stmt_send_long_data()方法配合bind_param的'b'类型标识符，这是最健壮和可靠的解决方案。如果文件尺寸较小，或者在特定配置下，将bind_param类型指定为's'（字符串）也可能有效。在实施任何解决方案之前，请务必检查并配置好MySQL服务器的max_allowed_packet和PHP的文件上传相关设置，并始终加入完善的错误处理机制。
以上就是PHP/MySQLi中BLOB数据写入数据库失败的解决方案的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
149
收藏
