萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 取得檔案副檔名的 4 種方法:pathinfo、explode、strrpos、SplFileInfo

前言

取得副檔名是檔案上傳、驗證、圖片處理的常見需求。PHP 提供多種方式,各有優缺點。本文比較 4 種主流方法並給出最佳實務建議。

方法一:pathinfo() 內建函數(推薦)

<?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,需自行判斷。

方法二:SplFileInfo 物件導向(現代、可擴展)

<?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
?>

方法三:strrpos + substr 手動截取(效能最佳、無函數呼叫開銷)

<?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 (最快)
?>

方法四:explode 分割陣列取最後元素(直觀但效能較差)

<?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⭐⭐⭐⭐⭐ (不推薦)

邊界情況測試表

檔名pathinfostrrposSplFileInfo說明
file.txttxttxttxt正常
.htaccess(空)(空)(空)隱藏檔,無副檔名
file.tar.gzgzgzgz取最後一段
file.(空)(空)(空)點在結尾,無副檔名
file(空)(空)(空)無點號
path/to/file.txttxttxt*txt*strrpos 需先 basename()
FILE.PNGPNGPNGPNG保留大小寫

實務建議

  1. 一般專案: 直接用 pathinfo($filename, PATHINFO_EXTENSION) 或 (new SplFileInfo($filename))->getExtension(),程式碼清晰、正確處理邊界。
  2. 高頻呼叫 (如每秒萬次上傳驗證): 使用 strrpos 版本,但必須先 basename() 移除路徑:
    $name = basename($filename); $pos = strrpos($name, '.'); ...
  3. 副檔名正規化: 一律 strtolower() 儲存與比對。
  4. 安全性: 副檔名不可作為檔案類型判斷依據,務必搭配 finfo 偵測真實 MIME。

總結

取得副檔名首選 pathinfo() 或 SplFileInfo,正確、可讀、免維護。極致效能場景才考慮手寫 strrpos,但須自行處理路徑與隱藏檔邊界。記得:副檔名只能參考,真實類型靠 MIME 偵測。

copyright © 萬盛學電腦網 all rights reserved