PHP 獲取檔案副檔名的三種高效方法與效能對比

方法一：pathinfo() - 官方推薦、功能最全

function getExt1(string $filename): string {
    $info = pathinfo($filename);
    return strtolower($info['extension'] ?? '');
}

// 測試
getExt1('image.PNG');        // 'png'
getExt1('/path/to/file');    // '' (無副檔名)
getExt1('archive.tar.gz');   // 'gz' (只取最後一段)
getExt1('.htaccess');        // '' (隱藏檔無副檔名)

優點：內建函式、正確處理路徑分隔符、支援無副檔名/多點檔名、可同時取得 dirname/basename/filename。
缺點：相對較慢 (解析完整路徑資訊)。

方法二：strrpos() + substr() - 極致效能

function getExt2(string $filename): string {
    $pos = strrpos($filename, '.');
    if ($pos === false || $pos === strlen($filename) - 1) return '';
    // 排除隱藏檔 (如 .htaccess) 視需求決定
    if ($pos === 0) return '';
    return strtolower(substr($filename, $pos + 1));
}

優點：純字串操作、無函式呼叫開銷、效能最佳 (約為 pathinfo 3-5 倍速)。
缺點：需自行處理邊界情況 (目錄含點、隱藏檔、無副檔名)。

方法三：explode() - 直觀易懂但效能較差

function getExt3(string $filename): string {
    $parts = explode('.', $filename);
    if (count($parts) <= 1) return '';
    return strtolower(end($parts));
}

缺點：建立陣列記憶體開銷大、explode 掃描整字串、隱藏檔會誤判第一段為空字串。

效能基準測試 (PHP 8.2, 100 萬次循環)

實務建議

• 高頻呼叫 (上萬次/請求)：使用 strrpos+substr 並內聯為靜態方法
• 一般業務邏輯：pathinfo() 可讀性最好、Bug 最少，優先選擇
• 需同時取得檔名/目錄：直接用 pathinfo() 一次取全
• 安全敏感場景：嚴格驗證副檔名白名單，勿信任用戶上傳檔名，改用隨機名 + 正確副檔名

現代 PHP 8.1+ 單行寫法

// 僅取副檔名，無則回傳空字串
$ext = strtolower(pathinfo($filename, PATHINFO_EXTENSION) ?? '');

// 或使用新函式 (PHP 8.3+)
$ext = strtolower(pathinfo($filename, PATHINFO_EXTENSION) ?: '');