PHP 取得檔案副檔名的多種高效方法比較

檔案副檔名擷取：方法比較與最佳實踐

取得副檔名是常見需求，PHP 提供多種方式，各有優缺點。本文比較四種主流方法的效能與適用場景。

方法一：pathinfo() 內建函數（推薦）

<?php
function getExtensionPathinfo($filename) {
    $info = pathinfo($filename);
    return strtolower($info['extension'] ?? '');
}

// 測試
echo getExtensionPathinfo('document.PDF');        // pdf
echo getExtensionPathinfo('/path/to/file.txt');   // txt
echo getExtensionPathinfo('archive.tar.gz');      // gz（只取最後一段）
echo getExtensionPathinfo('no_extension');        // 空字串
?>

優點： 內建函數、處理路徑分隔符、支援多語系檔名。
缺點： 相對較慢（解析完整路徑資訊）。

方法二：strrchr() + substr() 字串操作

<?php
function getExtensionStrrchr($filename) {
    // 找到最後一個點號位置
    $dotPos = strrpos($filename, '.');
    if ($dotPos === false) return '';
    return strtolower(substr($filename, $dotPos + 1));
}

// 或一行版
function getExtensionShort($filename) {
    return strtolower(substr(strrchr($filename, '.'), 1));
}
?>

優點： 速度極快、記憶體效率高。
缺點： 不處理路徑分隔符（目錄名含點會誤判）。

方法三：explode() 陣列分割

<?php
function getExtensionExplode($filename) {
    $parts = explode('.', $filename);
    return count($parts) > 1 ? strtolower(end($parts)) : '';
}

// array_reverse 版本
function getExtensionReverse($filename) {
    $parts = array_reverse(explode('.', $filename));
    return strtolower($parts[0] ?? '');
}
?>

優點： 邏輯直觀易懂。
缺點： 建立陣列額外開銷、同樣不處理路徑分隔符。

方法四：正則表達式

<?php
function getExtensionRegex($filename) {
    if (preg_match('/\.([a-z0-9]+)$/i', $filename, $matches)) {
        return strtolower($matches[1]);
    }
    return '';
}
?>

優點： 可精確控制合法字元。
缺點： 效能最差、過度設計。

效能基準測試（100萬次迴圈）

實務建議：安全封裝函數

<?php
function getFileExtension($filename) {
    // 1. 取得純檔名（移除路徑）
    $basename = basename($filename);
    
    // 2. 使用高效方法擷取
    $dotPos = strrpos($basename, '.');
    if ($dotPos === false || $dotPos === 0) {  // .hidden 檔案
        return '';
    }
    
    // 3. 可選：驗證副檔名格式
    $ext = strtolower(substr($basename, $dotPos + 1));
    if (!preg_match('/^[a-z0-9]+$/', $ext)) {
        return '';  // 非法字元
    }
    
    return $ext;
}

// 白名單驗證範例
$allowed = ['jpg', 'jpeg', 'png', 'gif', 'pdf', 'doc', 'docx'];
$ext = getFileExtension($_FILES['upload']['name']);
if (!in_array($ext, $allowed)) {
    die('不允許的檔案類型');
}
?>

特殊情況處理

• .htaccess、.gitignore：基名以點開頭，無副檔名
• archive.tar.gz：雙重副檔名，通常只取 gz
• file.：結尾為點，副檔名為空
• URL 參數：script.php?ver=1.2 需先 parse_url() 取路徑