0

0

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

聖光之護

聖光之護

发布时间:2026-01-16 16:55:12

|

213人浏览过

|

来源于php中文网

原创

如何批量下载 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),极大降低内存峰值。

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

<?php
require_once 'db3.php';

// ✅ 关键:启用无缓冲查询,避免内存爆炸
if (!mysqli_real_query($con, 'SELECT IMAGEID, LOCATION, IMAGEDATA FROM images')) {
    die('Query failed: ' . mysqli_error($con));
}
$result = mysqli_use_result($con);

// 设置响应头(仅用于页面展示,非下载响应)
header('Content-Type: text/html; charset=utf-8');
?>
<table class='table table-bordered table-striped'>
    <thead>
        <tr>
            <th>ImageId</th>
            <th>Location</th>
            <th>Status</th>
        </tr>
    </thead>
    <tbody>
        <?php
        $count = 0;
        $failed = 0;
        $basedir = '/tmp/retrieved-images/';

        // 确保目标目录存在且可写
        if (!is_dir($basedir)) {
            if (!mkdir($basedir, 0755, true)) {
                die("Failed to create directory: $basedir");
            }
        }

        while ($row = mysqli_fetch_row($result)) {
            $id   = trim((string)$row[0]); // IMAGEID(假设为第1列)
            $loc  = trim((string)$row[1]); // LOCATION(假设为第2列)
            $data = $row[2];               // IMAGEDATA(假设为第3列,BLOB)

            // 构建安全文件名:过滤非法字符,防止路径遍历
            $safeLoc = preg_replace('/[^a-zA-Z0-9._-]/', '_', $loc);
            $filename = $basedir . $id . '_' . $safeLoc;

            // 跳过空数据或超长文件名
            if (empty($data) || strlen($filename) > 255) {
                echo "<tr><td>$id</td><td>$loc</td><td>⚠️ Skipped (empty or invalid name)</td></tr>";
                $failed++;
                continue;
            }

            // 写入文件
            if (file_put_contents($filename, $data) !== false) {
                echo "<tr><td>$id</td><td>$loc</td><td>✅ Saved: " . basename($filename) . "</td></tr>";
                $count++;
            } else {
                echo "<tr><td>$id</td><td>$loc</td><td>❌ Failed to write: $filename</td></tr>";
                $failed++;
            }
        }

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

<p><strong>执行摘要:</strong>成功导出 <strong><?php echo $count; ?></strong> 张图像,<strong><?php echo $failed; ?></strong> 张失败。</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/851" title="PDFlux"><img
                                                                                src="https://img.php.cn/upload/ai_manual/000/000/000/175679987954548.jpg" alt="PDFlux"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/851" title="PDFlux">PDFlux</a>
                                                                        <p>PDF内容提取+智能问答神器,结合了科研级精准的非结构化文档解析能力,以及ChatGPT的智能问答能力。</p>
                                                                </div>
                                                                <a href="/ai/851" title="PDFlux" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记(深入)</a>”;</p>

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

  • 列索引需严格校验:$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 数据场景下稳定运行,兼顾性能、安全与可观测性,是处理数据库图像批量导出的推荐实践。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

683

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

472

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

286

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

519

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

265

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

392

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

542

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

665

2023.08.14

AI安装教程大全
AI安装教程大全

2026最全AI工具安装教程专题:包含各版本AI绘图、AI视频、智能办公软件的本地化部署手册。全篇零基础友好,附带最新模型下载地址、一键安装脚本及常见报错修复方案。每日更新,收藏这一篇就够了,让AI安装不再报错!

0

2026.03.04

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 2.4万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 842人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号