(PHP 4, PHP 5, PHP 7, PHP 8)
dirname — 返回路徑中的目錄部分
$path
, int $levels
= 1): string
給出一個包含有指向一個文件的全路徑的字符串,本函數(shù)返回去掉文件名后的目錄名,且目錄深度為 levels
級。
注意:
dirname() 純粹基于輸入字符串操作, 它不會受實際文件系統(tǒng)和類似 "
..
" 的路徑格式影響。
dirname() 是本地化的,所以如果要正確處理多字節(jié)字符的路徑,需要用 setlocale() 正確設置匹配的 locale。
path
一個路徑。
在 Windows 中,斜線(/
)和反斜線(\
)都可以用作目錄分隔符。在其它環(huán)境下是斜線(/
)。
levels
要向上的父目錄數(shù)量。
整型,必須大于 0。
返回 path 的父目錄。
如果在 path
中沒有斜線,則返回一個點('.
'),表示當前目錄。否則返回的是把
path
中結尾的
/component
(最后一個斜線以及后面部分)去掉之后的字符串。
版本 | 說明 |
---|---|
7.0.0 |
添加可選的 levels 參數(shù)。
|
示例 #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