(PHP 4 >= 4.0.3, PHP 5)
pathinfo — 返回文件路徑的信息
說明
mixed pathinfo ( string$path
[, int $options
= PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME
] )
pathinfo() 返回一個關聯數組包含有 path
的信息。返回關聯數組還是字符串取決于 options
。
參數
path
要解析的路徑。
options
如果指定了,將會返回指定元素;它們包括:PATHINFO_DIRNAME
,PATHINFO_BASENAME
和 PATHINFO_EXTENSION
或 PATHINFO_FILENAME
。
如果沒有指定 options
默認是返回全部的單元。
返回值
如果沒有傳入 options
,將會返回包括以下單元的數組 array:dirname,basename
和 extension(如果有),以 及filename。
Note:
If the path
does not have an extension, no
extension element will be returned(以下第二個案例)。
If options
is present, returns a
string containing the requested element.
更新日志
版本
說明
5.2.0
添加了常量 PATHINFO_FILENAME
。
范例
Example #1 pathinfo() 例子
<?php
$path_parts = pathinfo('/www/htdocs/inc/lib.inc.php');
echo $path_parts['dirname'], "n";
echo $path_parts['basename'], "n";
echo $path_parts['extension'], "n";
echo $path_parts['filename'], "n"; // since PHP 5.2.0
?>
以上例程會輸出:
/www/htdocs/inc lib.inc.php php lib.inc
Example #2 pathinfo() example showing difference between null and no extension
<?php
$path_parts = pathinfo('/path/emptyextension.');
var_dump($path_parts['extension']);
$path_parts = pathinfo('/path/noextension');
var_dump($path_parts['extension']);
?>
以上例程的輸出類似于:
string(0) "" Notice: Undefined index: extension in test.php on line 6 NULL
注釋
Note:
有關取得當前路徑信息的說明,請閱讀預定義變量一節。
Note:
pathinfo() is locale aware, so for it to parse a path containing multibyte characters correctly, the matching locale must be set using the setlocale() function.
參見
dirname() - 返回路徑中的目錄部分 basename() - 返回路徑中的文件名部分 parse_url() - 解析 URL,返回其組成部分 realpath() - 返回規范化的絕對路徑名