Base64 將二進位圖片編碼為文字,可直接嵌入 HTML/CSS/JSON,減少 HTTP 請求,但會增加 33% 體積。本文完整示範編碼解碼、Data URI 使用、檔案儲存與效能權衡。
<?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='嵌入圖片' />";
}
<?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 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 回傳 | 大圖、複用圖片、頻繁更新 |
<?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";