PHP图片上传脚本filedata字段无法存入数据库问题排查

针对脚本提示上传成功但MySQL LONGBLOB字段filedata为空的问题，结合手动插入正常的情况，排查方向和解决方法如下：

1. 检查表单与上传基础参数 #

• 确认HTML表单是否添加了enctype="multipart/form-data"属性，这是文件上传的必要条件，缺失会导致$_FILES数组为空：

  <form method="post" enctype="multipart/form-data" action="upload.php">
  

• 打印$_FILES数组验证上传状态：

  var_dump($_FILES['your_file_input_name']);
  

  重点检查error值是否为UPLOAD_ERR_OK（即0），size是否大于0，tmp_name是否存在有效路径。

2. 修正文件内容读取方式 #

• 必须读取服务器临时文件（tmp_name）而非客户端原文件名（name），错误写法会导致读取空内容：

  // 错误写法
  $file_data = file_get_contents($_FILES['file']['name']);
  // 正确写法
  $file_data = file_get_contents($_FILES['file']['tmp_name']);
  

• 验证读取结果：若$file_data为false，检查服务器临时目录（如/tmp）的PHP进程权限，确保可读取临时文件。

3. 使用预处理语句处理二进制数据 #

直接拼接SQL会导致二进制内容被转义截断，必须用预处理语句绑定LOB类型参数：

PDO示例 #

$stmt = $pdo->prepare("INSERT INTO your_table (filedata) VALUES (:filedata)");
// 指定参数类型为LOB，适配二进制数据
$stmt->bindParam(':filedata', $file_data, PDO::PARAM_LOB);
$stmt->execute();

MySQLi示例 #

$stmt = $mysqli->prepare("INSERT INTO your_table (filedata) VALUES (?)");
// 使用b类型绑定二进制数据
$stmt->bind_param("b", $file_data);
$stmt->execute();

4. 检查PHP配置限制 #

• 确认php.ini中以下参数值大于上传图片的大小：
  • upload_max_filesize：单个文件最大上传尺寸
  • post_max_size：POST请求总数据最大尺寸
• 可通过phpinfo()或脚本内打印配置值验证：

  echo "upload_max_filesize: " . ini_get('upload_max_filesize') . "<br>";
  echo "post_max_size: " . ini_get('post_max_size') . "<br>";
  

5. 避免临时文件提前销毁 #

确保在读取文件内容前，未通过unlink()或其他方式删除临时文件，且处理逻辑在同一个请求周期内完成（PHP会在请求结束后自动清理临时文件）。

内容的提问来源于stack exchange，提问作者jeff desjardins