pathinfo() / SplFileInfo內建函數、處理邊界情況 (無擴展名、多點、隱藏文件)、可讀性最佳、效能優異。
pathinfo() (推薦標準)function get_extension_pathinfo(string $filename): string {
return strtolower(pathinfo($filename, PATHINFO_EXTENSION));
}
// 測試
var_dump(get_extension_pathinfo('document.pdf')); // 'pdf'
var_dump(get_extension_pathinfo('archive.tar.gz')); // 'gz' (只取最後)
var_dump(get_extension_pathinfo('.htaccess')); // '' (隱藏文件無擴展名)
var_dump(get_extension_pathinfo('README')); // '' (無擴展名)
var_dump(get_extension_pathinfo('image.jpeg')); // 'jpeg'
var_dump(get_extension_pathinfo('/path/to/file.txt')); // 'txt' (含路徑無影響)
SplFileInfo::getExtension() (物件導向、PHP 5.3+)function get_extension_spl(string $filename): string {
return strtolower((new SplFileInfo($filename))->getExtension());
}
// 行為與 pathinfo 一致,提供物件介面,適合文件系統操作鏈
$file = new SplFileInfo($path);
$ext = $file->getExtension();
$size = $file->getSize();
$mtime = $file->getMTime();
substr() + strrchr() / explode() (手動解析,不推薦)// 3a: strrchr 找最後一個點
function get_extension_strrchr(string $filename): string {
$dotPos = strrpos($filename, '.');
if ($dotPos === false || $dotPos === strlen($filename) - 1) return '';
return strtolower(substr($filename, $dotPos + 1));
}
// 3b: explode 分割取最後 (效能差、易錯)
function get_extension_explode(string $filename): string {
$parts = explode('.', $filename);
return count($parts) > 1 ? strtolower(end($parts)) : '';
}
| 文件名 | pathinfo / SplFileInfo | strrchr | explode | 備註 |
|---|---|---|---|---|
file.txt | txt | txt | txt | 正常 |
archive.tar.gz | gz | gz | gz | 只取最後 |
.htaccess | '' (空) | htaccess (錯) | htaccess (錯) | 隱藏文件無擴展名 |
README | '' | '' | README (錯) | 無點 |
file. | '' | '' | '' | 結尾點 |
.hidden.file | file | file | file | 隱藏文件有擴展名 |
/path/to/file.php | php | php | php | 含路徑 |
pathinfo():~0.18 秒SplFileInfo:~0.22 秒 (物件創建開銷)strrchr:~0.12 秒 (最快,但邊界處理易漏)explode:~0.35 秒 (最慢,創建陣列)差異微乎其微,**正確性優先**。
function get_upload_extension(array $file): string {
// 1. 信任 MIME 類型驗證 (finfo) 而非副檔名
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
$allowed = ['image/jpeg' => 'jpg', 'image/png' => 'png', 'image/gif' => 'gif', 'application/pdf' => 'pdf'];
if (!isset($allowed[$mime])) {
throw new Exception('不允許的文件類型');
}
// 2. 副檔名僅作參考,以 MIME 映射為準
return $allowed[$mime];
}
// 使用
try {
$ext = get_upload_extension($_FILES['avatar']);
$newName = bin2hex(random_bytes(16)) . '.' . $ext;
move_uploaded_file($_FILES['avatar']['tmp_name'], UPLOAD_DIR . $newName);
} catch (Exception $e) {
// 處理錯誤
}
一般場景:pathinfo($file, PATHINFO_EXTENSION) — 簡潔、正確、標準。
物件風格/需更多文件信息:(new SplFileInfo($file))->getExtension()。
文件上傳安全處理:**忽略用戶提交副檔名**,用 finfo 驗證 MIME 類型並映射白名單擴展名。
**拒絕手寫解析** — 邊界情況極易出錯,維護成本高。