萬盛學電腦網

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

PHP 依據 MIME 類型自動對應檔案圖示函數(正則實作)

前言

在檔案管理、附件列表、下載頁面中,依據檔案類型顯示對應圖示能大幅提升使用者體驗。本文提供一個實用的 PHP 函數,透過正則比對 MIME 類型或副檔名,自動回傳對應的圖示檔名。

完整函數代碼

<?php
/**
 * 依據 MIME 類型或副檔名回傳對應圖示檔名
 *
 * @param string $type   MIME 類型(如 image/jpeg)或副檔名(如 jpg)
 * @param string $size   可選:尺寸後綴(如 '_small'、'_large')
 * @return string        圖示檔名(含尺寸後綴)
 */
function getFileIcon($type, $size = '') {
    // 圖示對應表:索引 => 檔名
    static $icons = [
        0  => 'common.gif',    // 預設/未知
        1  => 'image.gif',     // 圖片
        2  => 'binary.gif',    // 執行檔/二進位
        3  => 'rar.gif',       // 壓縮檔
        4  => 'msoffice.gif',  // Office 文件
        5  => 'text.gif',      // 純文字
        6  => 'html.gif',      // 網頁/腳本
        7  => 'real.gif',      // RealMedia
        8  => 'av.gif',        // 影音
        9  => 'flash.gif',     // Flash
        10 => 'pdf.gif',       // PDF
        11 => 'torrent.gif',   // BT 種子
    ];

    $type = strtolower($type);
    $typeId = 0; // 預設圖示

    // 依序比對,優先順序可依需求調整
    if (preg_match('/^image\//', $type) || preg_match('/\.(jpg|jpeg|gif|png|bmp|webp|svg)$/i', $type)) {
        $typeId = 1;
    } elseif (preg_match('/bittorrent|^torrent$/', $type) || preg_match('/\.torrent$/i', $type)) {
        $typeId = 11;
    } elseif (preg_match('/^application\/pdf$/', $type) || preg_match('/\.pdf$/i', $type)) {
        $typeId = 10;
    } elseif (preg_match('/flash|\.(swf|fla|swi)$/i', $type)) {
        $typeId = 9;
    } elseif (preg_match('/^(audio|video)\//', $type) || preg_match('/\.(wav|mid|mp3|m3u|wma|asf|asx|vqf|mpg|mpeg|avi|wmv|mp4|mkv|mov)$/i', $type)) {
        $typeId = 8;
    } elseif (preg_match('/real|\.(rm|rv|rmvb)$/i', $type)) {
        $typeId = 7;
    } elseif (preg_match('/^(text\/|application\/(x-)?(javascript|json|xml))/', $type) || preg_match('/\.(php|js|pl|cgi|asp|html?|css|xml|json)$/i', $type)) {
        $typeId = 6;
    } elseif (preg_match('/^text\//', $type) || preg_match('/\.(txt|rtf|wri|chm|md|log)$/i', $type)) {
        $typeId = 5;
    } elseif (preg_match('/(word|powerpoint|excel)|\.(docx?|pptx?|xlsx?)$/i', $type)) {
        $typeId = 4;
    } elseif (preg_match('/(zip|rar|tar|gz|7z|bz2)|\.(zip|rar|tar|gz|7z|bz2)$/i', $type)) {
        $typeId = 3;
    } elseif (preg_match('/octet-stream|\.(exe|com|bat|dll|bin|so|dylib)$/i', $type)) {
        $typeId = 2;
    }

    return $size . $icons[$typeId];
}
?>

使用範例

<?php
// 直接傳 MIME 類型
echo '<img src="icons/' . getFileIcon('image/png') . '" alt="PNG">'; // icons/image.gif

// 傳副檔名
echo '<img src="icons/' . getFileIcon('pdf') . '" alt="PDF">'; // icons/pdf.gif

// 加上尺寸後綴(需預先準備對應尺寸圖示)
echo '<img src="icons/' . getFileIcon('jpg', '_32') . '" alt="JPG">'; // icons/_32image.gif

// 批次處理檔案列表
$files = [
    ['name' => 'report.pdf', 'mime' => 'application/pdf'],
    ['name' => 'photo.jpg', 'mime' => 'image/jpeg'],
    ['name' => 'script.php', 'mime' => 'application/x-php'],
    ['name' => 'data.zip', 'mime' => 'application/zip'],
];

foreach ($files as $file) {
    $icon = getFileIcon($file['mime']);
    echo "<div class='file-item'><img src='icons/{$icon}'> {$file['name']}</div>";
}
?>

擴充建議

  1. 支援更多類型:在 $icons 陣列與正則規則中新增對應關係
  2. 使用 SVG 圖示:現代專案建議改用 SVG,可縮放且體積小
  3. 整合 Fileinfo 擴充:搭配 finfo_file() 取得真實 MIME 類型
  4. 快取機制:對相同類型結果快取,避免重複正則比對
  5. 前端圖示庫:考慮改用 FontAwesome、Bootstrap Icons 等字體圖示,減少圖片請求

正則模式速查

模式說明範例
/^image\//MIME 以 image/ 開頭image/jpeg, image/png
/\.(jpg|png)$/i副檔名為 jpg 或 png(不分大小寫)photo.JPG, image.png
/application\/pdf/精確比對 MIMEapplication/pdf
/(word|excel)/關鍵字比對application/msword
copyright © 萬盛學電腦網 all rights reserved