函式名稱:dirname()
適用版本:所有 PHP 版本
函式用法:dirname() 函式返回路徑中的目錄部分。
語法:dirname( string $path [, int $levels = 1 ] ) : string
引數:
- $path:要獲取目錄部分的路徑,可以是相對路徑或絕對路徑。
- $levels(可選):指定要向上返回的目錄層級,預設為 1。
返回值:返回指定路徑的目錄部分,如果沒有目錄部分,則返回一個點(.)。
注意事項:
- 如果給定的路徑是一個相對路徑,將會使用當前執行指令碼的目錄。
- 如果 $path 為空,返回 "." 。
- 目錄分隔符在 Windows 下是 "",在 Unix/Linux 下是 "/"。
示例:
// 示例 1:
$path = "/home/user/test/file.txt";
$dir = dirname($path);
echo $dir; // 輸出: /home/user/test
// 示例 2:
$path = "test/file.txt";
$dir = dirname($path);
echo $dir; // 輸出: test
// 示例 3:
$path = "file.txt";
$dir = dirname($path);
echo $dir; // 輸出: .
// 示例 4:
$path = "/var/www/html/";
$dir = dirname($path);
echo $dir; // 輸出: /var/www/html
// 示例 5:
$path = "C:\Program Files\Apache\htdocs\";
$dir = dirname($path);
echo $dir; // 輸出: C:\Program Files\Apache\htdocs
在示例 1 中,給定一個絕對路徑,函式返回路徑的目錄部分 "/home/user/test"。
在示例 2 中,給定一個相對路徑,函式返回路徑的目錄部分 "test"。
在示例 3 中,給定一個只有檔名的路徑,函式返回當前目錄 "."。
在示例 4 中,給定一個以目錄路徑結尾的路徑,函式返回相同的目錄路徑 "/var/www/html"。
在示例 5 中,給定一個 Windows 路徑,函式返回相同的目錄路徑 "C:\Program Files\Apache\htdocs"。