在檔案管理、附件列表、下載頁面中,依據檔案類型顯示對應圖示能大幅提升使用者體驗。本文提供一個實用的 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>";
}
?>
finfo_file() 取得真實 MIME 類型| 模式 | 說明 | 範例 |
|---|---|---|
/^image\// | MIME 以 image/ 開頭 | image/jpeg, image/png |
/\.(jpg|png)$/i | 副檔名為 jpg 或 png(不分大小寫) | photo.JPG, image.png |
/application\/pdf/ | 精確比對 MIME | application/pdf |
/(word|excel)/ | 關鍵字比對 | application/msword |