dirname

(PHP 4, PHP 5, PHP 7, PHP 8)

dirname返回路徑中的目錄部分

說明

dirname(string $path, int $levels = 1): string

給出一個(gè)包含有指向一個(gè)文件的全路徑的字符串,本函數(shù)返回去掉文件名后的目錄名,且目錄深度為 levels 級(jí)。

注意:

dirname() 純粹基于輸入字符串操作, 它不會(huì)受實(shí)際文件系統(tǒng)和類似 ".." 的路徑格式影響。

警告

dirname() 是本地化的,所以如果要正確處理多字節(jié)字符的路徑,需要用 setlocale() 正確設(shè)置匹配的 locale。

參數(shù)

path

一個(gè)路徑。

在 Windows 中,斜線(/)和反斜線(\)都可以用作目錄分隔符。在其它環(huán)境下是斜線(/)。

levels

要向上的父目錄數(shù)量。

整型,必須大于 0。

返回值

返回 path 的父目錄。 如果在 path 中沒有斜線,則返回一個(gè)點(diǎn)('.'),表示當(dāng)前目錄。否則返回的是把 path 中結(jié)尾的 /component(最后一個(gè)斜線以及后面部分)去掉之后的字符串。

更新日志

版本 說明
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

參見