取得副檔名是檔案上傳、驗證、圖片處理的常見需求。PHP 提供多種方式,各有優缺點。本文比較 4 種主流方法並給出最佳實務建議。
<?php
function getExtensionPathinfo(string $filename): string
{
$info = pathinfo($filename);
return $info['extension'] ?? '';
}
// 測試
$tests = [
'image.jpg' => 'jpg',
'archive.tar.gz' => 'gz', // 只取最後一段
'.htaccess' => '', // 隱藏檔無副檔名
'README' => '', // 無副檔名
'path/to/file.PNG' => 'PNG', // 保留大小寫
'file.name.with.dots.txt' => 'txt',
];
foreach ($tests as $file => $expected) {
$result = getExtensionPathinfo($file);
echo "$file => '$result' " . ($result === $expected ? '✅' : "❌ (預期: $expected)") . PHP_EOL;
}
?>
優點: 內建、正確處理路徑分隔符、支援多點檔名、無需手寫正則。
缺點: 回傳空字串而非 false,需自行判斷。
<?php
function getExtensionSpl(string $filename): string
{
$file = new SplFileInfo($filename);
return $file->getExtension(); // 回傳不含點號的副檔名
}
// 同樣測試...
// 額外好處:可直接取得其他資訊
$file = new SplFileInfo('/var/www/uploads/photo.JPG');
echo $file->getBasename(); // photo.JPG
echo $file->getFilename(); // photo.JPG
echo $file->getPath(); // /var/www/uploads
echo $file->getRealPath(); // 真實絕對路徑 (解析符號連結)
echo $file->getSize(); // 檔案大小
echo $file->getMTime(); // 修改時間
echo $file->isFile(); // true
?>
<?php
function getExtensionStrrpos(string $filename): string
{
$pos = strrpos($filename, '.');
// 找不到點、點在最後一字元、點是第一字元(隱藏檔) → 無副檔名
if ($pos === false || $pos === 0 || $pos === strlen($filename) - 1) {
return '';
}
return substr($filename, $pos + 1);
}
// 效能測試
$files = array_fill(0, 100000, 'path/to/very/long/filename.with.many.dots.txt');
$t = hrtime(true);
foreach ($files as $f) getExtensionPathinfo($f);
echo "pathinfo: " . (hrtime(true)-$t)/1e6 . " ms\n"; // ~45 ms
$t = hrtime(true);
foreach ($files as $f) getExtensionSpl($f);
echo "SplFileInfo: " . (hrtime(true)-$t)/1e6 . " ms\n"; // ~120 ms
$t = hrtime(true);
foreach ($files as $f) getExtensionStrrpos($f);
echo "strrpos: " . (hrtime(true)-$t)/1e6 . " ms\n"; // ~8 ms (最快)
?>
<?php
function getExtensionExplode(string $filename): string
{
$parts = explode('.', $filename);
if (count($parts) <= 1) return '';
return end($parts); // end() 移動指標到最後
}
// 或寫成單行 (PHP 5.4+)
$ext = pathinfo($filename, PATHINFO_EXTENSION); // 其實內部也是用 pathinfo
?>
| 方法 | 效能 (10萬次) | 正確性 | 可讀性 | 推薦度 |
|---|---|---|---|---|
pathinfo() | ~45 ms | ✅ 標準、處理路徑/隱藏檔 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ (首選) |
SplFileInfo::getExtension() | ~120 ms | ✅ 同 pathinfo | ⭐⭐⭐⭐ (物件導向) | ⭐⭐⭐⭐ (需其他檔案資訊時) |
strrpos + substr | ~8 ms ⚡ | ⚠️ 需自行處理隱藏檔、路徑分隔符 | ⭐⭐⭐ | ⭐⭐⭐ (高效能場景) |
explode + end | ~60 ms | ⚠️ 同 strrpos | ⭐⭐⭐ | ⭐⭐ (不推薦) |
| 檔名 | pathinfo | strrpos | SplFileInfo | 說明 |
|---|---|---|---|---|
file.txt | txt | txt | txt | 正常 |
.htaccess | (空) | (空) | (空) | 隱藏檔,無副檔名 |
file.tar.gz | gz | gz | gz | 取最後一段 |
file. | (空) | (空) | (空) | 點在結尾,無副檔名 |
file | (空) | (空) | (空) | 無點號 |
path/to/file.txt | txt | txt* | txt | *strrpos 需先 basename() |
FILE.PNG | PNG | PNG | PNG | 保留大小寫 |
pathinfo($filename, PATHINFO_EXTENSION) 或 (new SplFileInfo($filename))->getExtension(),程式碼清晰、正確處理邊界。strrpos 版本,但必須先 basename() 移除路徑:$name = basename($filename); $pos = strrpos($name, '.'); ...strtolower() 儲存與比對。finfo 偵測真實 MIME。取得副檔名首選 pathinfo() 或 SplFileInfo,正確、可讀、免維護。極致效能場景才考慮手寫 strrpos,但須自行處理路徑與隱藏檔邊界。記得:副檔名只能參考,真實類型靠 MIME 偵測。