PHP 将图片存入 MySQL 数据库的实现方法

陆遥

发布时间：2026-10-14 | 4人浏览过

原创

在处理多服务器架构或需要集中管理媒体资源时，将图片直接存入数据库比分散存储在文件系统上更具优势。本文将详细演示如何使用 PHP 接收前端上传的图片，并将其二进制流写入 MySQL 的 BLOB 字段中，同时展示如何从数据库读取数据并渲染为网页图片。

核心原理与准备工作

MySQL 提供了 BLOB（Binary Large Object）类型用于存储大量二进制数据。根据预计图片的大小，可以选择不同的 BLOB 变体：

TinyBlob：最大 255 字节，仅适合极小图标。
Blob：最大 65 KB，适用于小图。
MediumBlob：最大 16 MB，常规 Web 图片推荐使用此类型。
LongBlob：最大 4 GB，适用于超大文件或视频。

为了支持这一功能，我们需要创建一个数据表来存储图片信息。通常包含自增 ID、图片 MIME 类型以及存储二进制数据的字段。

以下是创建表的 SQL 语句。注意，表中使用了 MEDIUMBLOB 以容纳常见大小的图片，字符集建议设为 utf8mb4 以兼容更多元数据：

CREATE TABLE `photo` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `type` varchar(100) NOT NULL COMMENT '图片MIME类型',
  `binarydata` mediumblob NOT NULL COMMENT '图片二进制数据',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

PHP 实现上传图片到数据库

完整的逻辑可以封装在一个 PHP 文件中，通过 $_REQUEST['action'] 参数区分“上传”、“显示”和“列表展示”三种状态。以下代码展示了如何实现这一流程：

第1步：建立数据库连接

使用 PDO 或 MySQLi 替代已废弃的 mysql_* 函数以确保安全。这里演示基础连接逻辑：

// 建议使用 PDO 进行连接，防止 SQL 注入
$dsn = 'mysql:host=localhost;dbname=demo;charset=utf8mb4';
$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
];
try {
    $pdo = new PDO($dsn, 'root', '', $options);
} catch (PDOException $e) {
    die('连接失败: ' . $e->getMessage());
}

第2步：处理图片上传请求

当用户提交表单且 action 为 add 时，读取临时文件夹中的图片文件，转换为二进制字符串后插入数据库。为确保兼容性，可使用 base64 编码或直接二进制插入：

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_POST['action']) && $_POST['action'] === 'add') {
    if (isset($_FILES['photo']) && $_FILES['photo']['error'] === UPLOAD_ERR_OK) {
        $imageData = file_get_contents($_FILES['photo']['tmp_name']);
        $imageType = $_FILES['photo']['type'];

        // 使用预处理语句防止 SQL 注入
        $stmt = $pdo->prepare("INSERT INTO photo (type, binarydata) VALUES (?, ?)");
        $stmt->execute([$imageType, $imageData]);

        header('Location: ' . $_SERVER['PHP_SELF']);
        exit;
    }
}

第3步：构建前端上传表单

上传界面是一个标准的 HTML 表单，必须设置 enctype="multipart/form-data" 才能正确传输文件：

<form method="post" action="upload.php" enctype="multipart/form-data">
    <p>选择图片：<input type="file" name="photo" /></p>
    <input type="hidden" name="action" value="add">
    <input type="submit" value="提交上传">
</form>

从数据库读取并显示图片

要让浏览器能识别并显示存储在数据库中的图片，不能直接在 HTML <img> 标签中嵌入数据库记录。正确做法是创建一个专门的接口脚本（如本例中的同一文件处理逻辑），通过设置正确的 HTTP 响应头输出二进制流。

第4步：生成图片预览列表

在页面上列出所有已上传的图片，src 属性指向同一个脚本并携带 show 动作和对应的 ID：

<?php
// 假设 $pdo 已连接
$stmt = $pdo->query("SELECT id FROM photo ORDER BY id DESC");
while ($row = $stmt->fetch()) {
    // 链接指向当前页面，传递 show 参数和图片ID
    echo "<img src='\" . $_SERVER['PHP_SELF'] . "?action=show&id=" . htmlspecialchars($row['id']) . "' width='150' />";
}
?>

第5步：执行图片输出逻辑

当 URL 中包含 ?action=show&id=X 时，脚本应查询该 ID 对应的记录，设置 Content-Type 并输出二进制内容：

if (isset($_GET['action']) && $_GET['action'] === 'show' && isset($_GET['id'])) {
    $id = intval($_GET['id']);
    $stmt = $pdo->prepare("SELECT type, binarydata FROM photo WHERE id = ?");
    $stmt->execute([$id]);
    $result = $stmt->fetch();

    if ($result) {
        // 告知浏览器这是何种类型的图片
        header('Content-Type: ' . $result['type']);
        // 输出原始二进制数据
        echo $result['binarydata'];
        exit;
    }
}