萬盛學電腦網

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

PHP 路徑解析函數詳解:dirname、basename、pathinfo

PHP 檔案路徑解析三劍客:dirname、basename、pathinfo

處理檔案路徑時,常需取得目錄名、檔名、副檔名。PHP 提供三個核心函數,各有專長。

1. basename() — 取得檔案名稱

string basename ( string $path [, string $suffix = "" ] )
  • 回傳路徑中的**檔案名稱**部分。
  • 可選 $suffix:若檔名以此結尾,則移除 (常用於去除副檔名)。
  • Windows 下 / 和 \ 皆視為分隔符;其他系統僅 /。

範例

<?php
$path = '/home/httpd/html/index.php';
echo basename($path);        // index.php
echo basename($path, '.php'); // index
?>

2. dirname() — 取得目錄路徑

string dirname ( string $path )
  • 回傳**去掉檔名後的目錄路徑** (不含尾端分隔符)。
  • 常用於包含檔案:require dirname(__FILE__) . '/config.php'; (PHP 5.3+ 建議用 __DIR__)。
  • 巢狀呼叫:dirname(dirname(__FILE__)) 取得上兩層目錄。

範例

<?php
echo dirname('c:/testweb/home.php'); // c:/testweb
echo dirname('/testweb/home.php');   // /testweb
echo dirname(__DIR__); // 專案根目錄 (若檔案在 src/ 下)
?>

3. pathinfo() — 完整路徑資訊陣列

array|string pathinfo ( string $path [, int $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME ] )
  • 不帶 $options 回傳關聯陣列:dirname, basename, extension (副檔名), filename (不含副檔名的檔名, PHP 5.2+)。
  • 帶 $options 旗標 (可用 | 組合) 時回傳對應字串。

範例

<?php
$path = '/testweb/test.txt';
print_r(pathinfo($path));
/*
Array
(
    [dirname] => /testweb
    [basename] => test.txt
    [extension] => txt
    [filename] => test
)
*/

// 只取副檔名
echo pathinfo($path, PATHINFO_EXTENSION); // txt

// 只取檔名 (不含副檔名)
echo pathinfo($path, PATHINFO_FILENAME); // test

// 組合旗標
print_r(pathinfo($path, PATHINFO_DIRNAME | PATHINFO_BASENAME));
/*
Array
(
    [dirname] => /testweb
    [basename] => test.txt
)
*/
?>

常見應用場景

需求推薦函數/寫法
取得目前腳本目錄__DIR__ (魔術常數, PHP 5.3+)
取得專案根目錄dirname(__DIR__, 2) (PHP 7.0+ 支援層級參數) 或 realpath(__DIR__ . '/../')
安全包含檔案require __DIR__ . '/../config.php';
上傳檔案重命名保留副檔名$ext = pathinfo($filename, PATHINFO_EXTENSION); $new = uniqid() . '.' . $ext;
判斷副檔名是否允許in_array(pathinfo($name, PATHINFO_EXTENSION), $allowed, true)
取得不含副檔名的檔名pathinfo($name, PATHINFO_FILENAME)

注意事項

  • pathinfo() **不感知實際檔案系統**,純字串操作。
  • 多位元組字元 (中文檔名) 在 PHP 7.1+ 正確支援;舊版可能需 mb_pathinfo() 自行實作。
  • URL 路徑解析請用 parse_url(),而非此三函數。
copyright © 萬盛學電腦網 all rights reserved