萬盛學電腦網

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

PHP Base64 圖片編碼與解碼:Data URI 嵌入、檔案儲存與效能考量

Base64 將二進位圖片編碼為文字,可直接嵌入 HTML/CSS/JSON,減少 HTTP 請求,但會增加 33% 體積。本文完整示範編碼解碼、Data URI 使用、檔案儲存與效能權衡。

圖片轉 Base64(編碼)

<?php
/**
 * 圖片檔案轉 Base64 Data URI
 * @param string $path 圖片路徑
 * @return string|false Data URI 字串或失敗
 */
function imageToDataUri(string $path): string|false {
    if (!is_file($path) || !is_readable($path)) return false;

    $mime = mime_content_type($path);
    if (!preg_match('/^image\/(jpeg|png|gif|webp|bmp|svg\+xml)$/i', $mime)) {
        return false;
    }

    $data = file_get_contents($path);
    $b64 = base64_encode($data);
    return "data:$mime;base64,$b64";
}

// 使用
$dataUri = imageToDataUri('photo.jpg');
if ($dataUri) {
    echo "<img src='$dataUri' alt='嵌入圖片' />";
}

Base64 解碼儲存檔案

<?php
/**
 * Base64 Data URI 解碼存檔
 * @param string $dataUri Data URI 字串
 * @param string $saveDir 儲存目錄
 * @return string|false 儲存路徑或失敗
 */
function dataUriToFile(string $dataUri, string $saveDir = 'uploads'): string|false {
    if (!preg_match('/^data:(image\/[a-z+]+);base64,(.+)$/i', $dataUri, $m)) {
        return false;
    }
    [$mime, $b64] = [$m[1], $m[2]];

    $data = base64_decode($b64, true); // strict mode
    if ($data === false) return false;

    // 驗證檔案簽名(Magic Bytes)
    $signatures = [
        'image/jpeg' => "\xFF\xD8\xFF",
        'image/png'  => "\x89PNG\r\n\x1A\n",
        'image/gif'  => 'GIF87a', // 或 GIF89a
        'image/webp' => 'RIFF',   // 需進一步檢查 WEBP
    ];
    $sig = $signatures[$mime] ?? '';
    if ($sig && strncmp($data, $sig, strlen($sig)) !== 0) {
        return false; // 檔案頭不符
    }

    // 建立目錄
    if (!is_dir($saveDir)) mkdir($saveDir, 0755, true);

    // 生成檔名
    $ext = [
        'image/jpeg' => 'jpg',
        'image/png'  => 'png',
        'image/gif'  => 'gif',
        'image/webp' => 'webp',
    ][$mime] ?? 'bin';
    $filename = $saveDir . '/' . bin2hex(random_bytes(8)) . '.' . $ext;

    if (file_put_contents($filename, $data) === false) return false;
    return $filename;
}

// 使用:前端傳來的 Data URI 存檔
$path = dataUriToFile($_POST['image_data'] ?? '');
echo $path ? "儲存成功: $path" : "儲存失敗";

HTML/CSS 中直接嵌入

<!-- HTML img -->
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." alt="Logo" />

<!-- CSS background -->
<style>
.logo { background-image: url("data:image/svg+xml;base64,PHN2ZyB4bWxucz0..."); }
</style>

效能與體積權衡

項目Base64 Data URI外部檔案
體積增加+33%(Base64 編碼膨脹)原始大小
HTTP 請求數0(內嵌)1 請求/圖片
快取機制隨 HTML/CSS 快取獨立快取、可 CDN
首屏渲染無額外 RTT需額外請求
適用場景小圖標、關鍵 CSS 圖片、Email、API 回傳大圖、複用圖片、頻繁更新

最佳實踐建議

  1. 小於 1-2 KB 的圖標/裝飾圖:內嵌 Base64 減少請求
  2. 大於 5 KB:改用外部檔案 + CDN + HTTP/2 多路複用
  3. 關鍵渲染路徑:Hero 圖片、Logo 可內嵌避免閃爍
  4. Email/PDF 生成:Base64 為唯一可行嵌入方式
  5. API 回傳圖片:JSON 中嵌入 Base64,前端直接渲染

批量轉換工具腳本

<?php
// batch_encode.php - 目錄下所有圖片轉 Base64 存 JSON
$dir = 'images';
$out = [];
foreach (glob("$dir/*.{jpg,png,gif,webp,svg}", GLOB_BRACE) as $file) {
    $uri = imageToDataUri($file);
    if ($uri) $out[basename($file)] = $uri;
}
file_put_contents('images_base64.json', json_encode($out, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE));
echo "完成,共 " . count($out) . " 張圖片\n";
copyright © 萬盛學電腦網 all rights reserved