萬盛學電腦網

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

PHP 生成 CSS Sprite 雪碧圖:掃描目錄自動合成圖片與樣式表

原理與優勢

CSS Sprite 將多張小圖標合並為一張大圖,通過 background-position 定位顯示,減少 HTTP 請求數,提升頁面加載速度。本文提供一個掃描目錄、自動橫向拼接、生成對應 CSS 的完整 PHP 腳本。

完整生成腳本 (sprite.php)

<?php
$srcdir = './image/';      // 源圖片目錄 (僅 PNG)
$prefix = 'pic11_';        // CSS 類名前綴
$dst = 'sprite';           // 輸出文件名前綴 (sprite.png, sprite.css)

$files = array_diff(scandir($srcdir), ['.', '..']);
$images = [];
$totalWidth = 0;
$maxHeight = 0;

// 1. 收集圖片信息
foreach ($files as $file) {
    $path = $srcdir . $file;
    $info = @getimagesize($path);
    if (!$info) continue; // 跳過非圖片/損壞文件
    $images[] = ['path' => $path, 'name' => pathinfo($file, PATHINFO_FILENAME), 'w' => $info[0], 'h' => $info[1]];
    $totalWidth += $info[0];
    $maxHeight = max($maxHeight, $info[1]);
}

if (empty($images)) die('無有效圖片');

// 2. 創建畫布 (真彩色 + Alpha 透明)
$canvas = imagecreatetruecolor($totalWidth, $maxHeight);
imagesavealpha($canvas, true);
$transparent = imagecolorallocatealpha($canvas, 0, 0, 0, 127);
imagefill($canvas, 0, 0, $transparent);

// 3. 橫向拼接並生成 CSS
$css = '';
$x = 0;
foreach ($images as $img) {
    $im = imagecreatefrompng($img['path']);
    imagecopy($canvas, $im, $x, 0, 0, 0, $img['w'], $img['h']);
    imagedestroy($im);

    // CSS 規則:寬高 + 定位
    $css .= ".{$prefix}{$img['name']} { width: {$img['w']}px; height: {$img['h']}px; background-position: -{$x}px 0; }\n";
    $x += $img['w'];
}

// 4. 通用基類
$css = ".{$prefix} { background-image: url('{$dst}.png'); display: inline-block; vertical-align: middle; }\n" . $css;

// 5. 輸出文件
file_put_contents("{$dst}.css", $css);
imagepng($canvas, "{$dst}.png");
imagedestroy($canvas);

echo "生成完成:{$dst}.png ({$totalWidth}x{$maxHeight})、{$dst}.css (" . count($images) . " 個類)\n";

生成的 CSS 結構示例

.pic11 { background-image: url('sprite.png'); display: inline-block; vertical-align: middle; }
.pic11_css3 { width: 32px; height: 32px; background-position: -0px 0; }
.pic11_firefox { width: 32px; height: 32px; background-position: -32px 0; }
.pic11_chrome { width: 32px; height: 32px; background-position: -64px 0; }

前端使用

<link rel="stylesheet" href="sprite.css">
<div class="pic11 pic11_css3"></div>
<div class="pic11 pic11_firefox"></div>
<span class="pic11 pic11_chrome"></span>

進階優化方向

  • 智能佈局:雙向填充 (Bin Packing) 而非單純橫向,減小畫布面積。
  • 多格式支持:imagecreatefromjpeg/gif/webp 統一轉 PNG 合成,或保持原格式 (需 CSS 分組)。
  • Retina/@2x/@3x:生成多倍圖,CSS background-size 縮放。
  • 壓縮優化:調用 pngquant/optipng 壓縮輸出 PNG。
  • 構建工具集成:納入 Webpack/Gulp/Vite 構建流程 (如 webpack-spritesmith),而非運行時生成。
  • 緩存清除:文件名加 Hash (如 sprite.a1b2c3.png) 解決瀏覽器緩存。

常見問題

總結

PHP GD 庫輕鬆實現 Sprite 自動化生成。理解「畫布創建 → 逐個拼接 → 記錄座標 → 生成 CSS」流程,即可根據項目需求擴展為構建時任務或運行時服務。

copyright © 萬盛學電腦網 all rights reserved
問題解決
圖片間有縫隙/模糊確保圖片尺寸為偶數、背景透明、imagecopy 坐標為整數
CSS 類名衝突使用項目專用前綴 (如 icon-、spr-)
大量圖片導致畫布超限分組生成多張 Sprite、或改用 SVG Symbol / Font Icon