dirname
(PHP 4, PHP 5, PHP 7, PHP 8)
dirname — 返回路徑中的目錄部分
說明
dirname(string
$path, int $levels = 1): string
給出一個包含有指向一個檔案的全路徑的字串，本函式返回去掉檔名后的目錄名，且目錄深度為 levels 級。
注意:
dirname() 純粹基於輸入字串操作， 它不會受實際檔案系統和類似 "
.." 的路徑格式影響。
警告
dirname() 是本地化的，所以如果要正確處理多位元組字元的路徑，需要用 setlocale() 正確設定匹配的 locale。
參數
-
path -
一個路徑。
在 Windows 中，斜線（
/）和反斜線（\）都可以用作目錄分隔符。在其它環境下是斜線（/）。 -
levels -
要向上的父目錄數量。
整型，必須大於 0。
返回值
返回 path 的父目錄。
如果在 path
中沒有斜線，則返回一個點（'.'），表示目前目錄。否則返回的是把
path 中結尾的
/component（最後一個斜線以及後面部分）去掉之後的字串。
更新日誌
| 版本 | 說明 |
|---|---|
| 7.0.0 |
新增可選的 levels 參數。
|
範例
示例 #1 dirname() 例子
<?php
echo dirname("/etc/passwd") . PHP_EOL;
echo dirname("/etc/") . PHP_EOL;
echo dirname(".") . PHP_EOL;
echo dirname("C:\\") . PHP_EOL;
echo dirname("/usr/local/lib", 2);
以上例程的輸出類似於：
/etc / (or \ on Windows) . C:\ /usr