如何批量下载 MySQL 中存储的 BLOB 图像（PHP 实现）

本文详解如何使用 php 高效批量导出 mysql 表中以 mediumblob 形式存储的 jpg 图像，解决内存溢出、查询失败和文件写入无效等常见问题，并提供安全、稳定、可落地的生产级代码方案。

在 Web 应用中，将图像以 MEDIUMBLOB 类型直接存入 MySQL 是一种常见但需谨慎处理的设计。当需要一次性导出数千张图片时，常规的 mysqli_query() + mysqli_fetch_array() 方式极易触发 PHP 内存限制（如 memory_limit=128M），导致脚本崩溃、页面空白或仅返回标题——这正是提问者遇到的核心问题：*`SELECT FROM images无法完成结果集加载，$row["IMAGEDATA"]` 取值失败，后续文件写入自然失效**。

根本原因在于：mysqli_query() 会将整个结果集（含所有 BLOB 数据）一次性加载到 PHP 内存中。假设每张图平均 500KB，1000 张即占用约 500MB 内存，远超默认配置。

✅ 正确解法是改用 流式查询（Unbuffered Query）：
通过 mysqli_real_query() + mysqli_use_result() 组合，让 MySQL 逐行返回数据，PHP 每次只在内存中保留单行（含单个 BLOB），极大降低内存峰值。

以下是经过验证的完整批量导出方案：

 255) {
                echo "";
                $failed++;
                continue;
            }

            // 写入文件
            if (file_put_contents($filename, $data) !== false) {
                echo "";
                $count++;
            } else {
                echo "";
                $failed++;
            }
        }

        mysqli_free_result($result); // 显式释放结果集资源
        ?>
    

    

        

            
ImageId
            
Location
            
Status
        
    
    

        
$id
$loc
⚠️ Skipped (empty or invalid name)
$id
$loc
✅ Saved: " . basename($filename) . "
$id
$loc
❌ Failed to write: $filename


执行摘要：成功导出  张图像， 张失败。

							

								
								

									文心智能体平台
									
百度推出的基于文心大模型的Agent智能体平台，已上架2000+AI智能体
								
								下载 
							
						
立即学习“PHP免费学习笔记（深入）”；

? 关键注意事项与最佳实践：

• 列索引需严格校验：$row[0]、$row[1]、$row[2] 对应 SELECT 中字段顺序。务必先用 DESCRIBE images 确认 IMAGEID、LOCATION、IMAGEDATA 的实际位置，避免越界或取错字段。
• 目录权限与路径安全：/tmp/retrieved-images/ 必须由 Web 服务器用户（如 www-data）可写；禁止使用用户输入直接拼接路径，已通过 preg_replace 过滤文件名。
• 错误处理不可省略：检查 file_put_contents() 返回值，捕获磁盘满、权限拒绝等异常。
• 大文件场景优化建议：
  • 增加 set_time_limit(0) 防止超时；
  • 添加 ob_flush() + flush() 实时输出进度（需启用输出缓冲）；
  • 生产环境推荐改用 CLI 模式运行（php bulk_download.php），规避 Web 服务器超时与内存限制。
• 替代方案（更健壮）：对万级图片，建议生成 ZIP 包（使用 ZipArchive）而非散列文件，提升传输与管理效率。

该方案已在真实千级 BLOB 数据场景下稳定运行，兼顾性能、安全与可观测性，是处理数据库图像批量导出的推荐实践。