萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 圖片上傳存入資料庫 (BLOB) 完整實作:PDO 預處理、十六進制編碼與輸出

將圖片二進制資料直接存入資料庫 BLOB 欄位,優點:資料完整性強、備份簡單、刪除同步;缺點:資料庫膨脹、備份還原慢、不利 CDN 分發。本文提供完整實作:表結構、上傳表單、PDO 預處理寫入、十六進制編碼、圖片輸出與安全考量。

資料表結構

CREATE TABLE `upload` (
    `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
    `type` varchar(20) NOT NULL COMMENT 'MIME 類型',
    `data` mediumblob NOT NULL COMMENT '圖片二進制資料 (max 16MB)',
    PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

BLOB 型別選擇:TINYBLOB(255B)、BLOB(64KB)、MEDIUMBLOB(16MB)、LONGBLOB(4GB)。圖片建議 MEDIUMBLOB。

上傳表單 (index.html)

<!doctype html>
<html><head><title>圖片上傳</title></head><body>
<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="file" name="file" id="file" accept="image/*" />
    <input type="submit" value="上傳" />
</form>
</body></html>

上傳處理 (upload.php)

<?php
// upload.php
if ($_FILES['file']['error'] !== UPLOAD_ERR_OK) {
    die("上傳錯誤代碼: {$_FILES['file']['error']}");
}

$type = $_FILES['file']['type'];
$size = $_FILES['file']['size'];
$tmp  = $_FILES['file']['tmp_name'];

// 安全驗證
$allowedTypes = ['image/gif', 'image/jpeg', 'image/png', 'image/webp'];
if (!in_array($type, $allowedTypes)) die("不支援的圖片格式");
if ($size > 5 * 1024 * 1024) die("檔案過大 (限 5MB)");

// 讀取二進制並轉十六進制 (避免 SQL 注入與特殊字元)
$fp = fopen($tmp, 'rb');
$binary = fread($fp, $size);
fclose($fp);
$hexData = bin2hex($binary);

$dsn = 'mysql:host=localhost;dbname=test;charset=utf8mb4';
try {
    $pdo = new PDO($dsn, 'root', 'root', [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_EMULATE_PREPARES => false
    ]);
    
    // 參數化查詢:0x 表示十六進制字面值
    $stmt = $pdo->prepare("INSERT INTO `upload` (`type`, `data`) VALUES (?, 0x$hexData)");
    $stmt->execute([$type]);
    
    $id = $pdo->lastInsertId();
    echo "上傳成功! <a href='view.php?id=$id'>查看圖片</a>";
    
} catch (PDOException $e) {
    error_log("Upload error: " . $e->getMessage());
    die("系統錯誤,請稍後再試");
}
?>

圖片輸出 (view.php)

<?php
// view.php
$id = $_GET['id'] ?? '';
if (!ctype_digit($id)) die("無效 ID");

$dsn = 'mysql:host=localhost;dbname=test;charset=utf8mb4';
try {
    $pdo = new PDO($dsn, 'root', 'root', [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
    ]);
    
    $stmt = $pdo->prepare("SELECT `type`, `data` FROM `upload` WHERE `id` = ?");
    $stmt->execute([$id]);
    $row = $stmt->fetch(PDO::FETCH_ASSOC);
    
    if (!$row) die("圖片不存在");
    
    // 設定正確 Content-Type
    header("Content-Type: {$row['type']}");
    // 建議快取
    header("Cache-Control: public, max-age=31536000");
    header("Content-Length: " . strlen($row['data']));
    
    // 直接輸出二進制
    echo $row['data'];
    
} catch (PDOException $e) {
    error_log("View error: " . $e->getMessage());
    die("系統錯誤");
}
?>

關鍵技術點解析

技術點說明
bin2hex()二進制轉十六進制字串,安全嵌入 SQL,無需轉義
0x$hexDataMySQL 十六進制字面值語法,直接寫入 BLOB
PDO::ATTR_EMULATE_PREPARES = false使用真正預處理,防 SQL 注入
fopen($tmp, 'rb')二進制讀取模式,跨平台相容
ctype_digit($id)嚴格驗證數字 ID,防注入

效能與架構優化建議

  • 大檔案分塊上傳:Plupload/WebUploader 分片,資料庫存檔案元資料而非二進制
  • 異步處理:上傳存暫存表,背景任務轉移至對象儲存 (S3/MinIO/OSS),DB 僅存 URL
  • 讀取快取:熱門圖片加 Redis 快取,減輕 DB 壓力
  • 資料庫分離:圖片表獨立資料庫/實例,避免影響核心業務
  • 監控指標:表大小、寫入 QPS、慢查詢、備份耗時

刪除圖片 (delete.php)

<?php
$id = $_POST['id'] ?? '';
if (!ctype_digit($id)) die("無效 ID");

$pdo = new PDO($dsn, 'root', 'root');
$stmt = $pdo->prepare("DELETE FROM `upload` WHERE `id` = ?");
$stmt->execute([$id]);
echo $stmt->rowCount() ? "刪除成功" : "不存在";
?>

BLOB 存儲適合中小型、存取頻率低、強一致性要求高的場景。大規模、高併發、需 CDN 分發的業務,請採用「資料庫存元資料 + 對象儲存存二進制」架構。

copyright © 萬盛學電腦網 all rights reserved