PHP 獲取文件擴展名的三種方法：性能、健壯性與最佳實踐深度對比

核心需求：文件上傳、解析、路由中的關鍵步驟

獲取文件擴展名看似簡單，實則暗藏陷阱：多點文件（archive.tar.gz）、無擴展名文件、大小寫不一、路徑而非文件名輸入。本文對比三種主流方法，給出生產環境推薦方案。

方法一：strrpos + substr 手動解析（不推薦）

function getExtV1(string $filename): string {
    $pos = strrpos($filename, '.');
    if ($pos === false) return '';
    return substr($filename, $pos + 1);
}

缺陷

• ❌ 不處理路徑分隔符：/path/to/file.txt 正常，但 ./file 或 Windows 路徑可能誤判
• ❌ 不處理隱藏文件：.gitignore 會返回 gitignore（實為無擴展名）
• ❌ 大小寫不統一：返回原始大小寫，需額外 strtolower()
• ❌ 性能一般：雙函數調用 + 邊界判斷

方法二：pathinfo() 內置函數（推薦標準方案）

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

優勢

• ✅ 內置處理路徑分隔符、多點、隱藏文件邏輯
• ✅ 返回結構化信息（dirname、basename、extension、filename）
• ✅ C 層實現，性能優異
• ✅ 代碼語義清晰，可讀性最強

注意

• ⚠️ PHP 5.3+ 才支持 PATHINFO_EXTENSION 常量單獨獲取
• ⚠️ 無擴展名時 extension 鍵不存在，需用 ?? '' 防警告

方法三：explode() 分割取末尾（不推薦）

function getExtV3(string $filename): string {
    $parts = explode('.', $filename);
    return strtolower(end($parts));
}

致命缺陷

• ❌ .htaccess → ['', 'htaccess'] 返回 htaccess（誤判）
• ❌ file. → ['file', ''] 返回空字符串（正確）但語義混亂
• ❌ 路徑分隔符干擾：path/to/file 無點時返回整個路徑
• ❌ 生成臨時數組，內存與性能雙重劣勢

性能基準測試（100萬次調用）

生產環境最佳實踐：封裝通用工具類

class FileUtil {
    public static function getExtension(string $path): string {
        // 1. 過濾查詢字符串、片段標識
        $path = parse_url($path, PHP_URL_PATH) ?? $path;
        
        // 2. 核心解析
        $ext = pathinfo($path, PATHINFO_EXTENSION);
        
        // 3. 標準化：小寫、去除非字母數字字符（防注入）
        return strtolower(preg_replace('/[^a-z0-9]/i', '', $ext));
    }
    
    public static function isAllowedExtension(string $filename, array $allowed): bool {
        return in_array(self::getExtension($filename), $allowed, true);
    }
}

// 使用示例
$allowed = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'doc', 'docx'];
if (FileUtil::isAllowedExtension($_FILES['avatar']['name'], $allowed)) {
    // 通過擴展名初步校驗，後續必須配合 MIME 類型、文件頭魔數二次驗證
}

總結

pathinfo() 是獲取擴展名的標準答案：語義正確、性能最優、邊界處理最完善。切記：擴展名校驗僅是第一道防線，務必結合 finfo_file() 檢測真實 MIME 類型、文件頭魔數驗證、存儲重命名、執行權限剝離，構建完整文件上傳安全體系。