PHP 8.3.4 Released!

pathinfo

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

pathinfo返回文件路径的信息

说明

pathinfo(string $path, int $flags = PATHINFO_ALL): array|string

pathinfo() 返回一个关联数组包含有 path 的信息。返回关联数组还是字符串取决于 flags

注意:

有关取得当前路径信息的说明,请阅读 预定义变量 一节。

注意:

pathinfo() 纯粹基于输入字符串操作, 它不会受实际文件系统和类似 ".." 的路径格式影响。

注意:

反斜线字符 \ 仅在 Windows 系统上会解释为目录分隔符。在其他系统上,它将视为普通字符。

警告

pathinfo() 是本地化的,所以为了让它能正确地解析一个包含多字节编码的路径, 必须使用 setlocale() 函数来设置地区信息。

参数

path

要解析的路径。

flags

如果指定了,将会返回指定元素;它们包括: PATHINFO_DIRNAMEPATHINFO_BASENAMEPATHINFO_EXTENSIONPATHINFO_FILENAME

如果没有指定 flags 默认是返回全部的单元。

返回值

如果没有传入 options ,将会返回包括以下单元的数组 arraydirnamebasenameextension(如果有),以及filename

注意:

如果 path 有一个以上的扩展名, PATHINFO_EXTENSION 只返回最后一个,而 PATHINFO_FILENAME 仅剥离最后一个。 (参考第一个示例)。

注意:

如果 path 没有扩展名,返回数据中就不会有 extension 元素。(参考第二个示例)

注意:

如果 path 中的 basename 以点开始, 那后面的字符串将被解释为 extension , 并且 filename 为空。(参考第三个示例)

如果 flags 存在的, 则返回一个包含请求元素的 string

示例

示例 #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";
?>

以上示例会输出:

/www/htdocs/inc
lib.inc.php
php
lib.inc

示例 #2 pathinfo() 对比空扩展名和无扩展名之间区别的示例

<?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

示例 #3 pathinfo() 形如 .file 的示例

<?php
print_r
(pathinfo('/some/path/.test'));
?>

以上示例的输出类似于:

Array
(
    [dirname] => /some/path
    [basename] => .test
    [extension] => test
    [filename] =>
)

示例 #4 pathinfo() 示例和解除数组引用

flags 参数不是位掩码。只能提供单个值。要是只选择某些格式化值,请使用数组解构,如下所示:

<?php
['basename' => $basename, 'dirname' => $dirname] = pathinfo('/www/htdocs/inc/lib.inc.php');

var_dump($basename, $dirname);
?>

以上示例的输出类似于:

string(11) "lib.inc.php"
string(15) "/www/htdocs/inc"

参见

add a note

User Contributed Notes 4 notes

up
41
Lori
5 years ago
Simple example of pathinfo and array destructuring in PHP 7:
<?php
[ 'basename' => $basename, 'dirname' => $dirname ] = pathinfo('/www/htdocs/inc/lib.inc.php');

var_dump($basename, $dirname);

// result:
// string(11) "lib.inc.php"
// string(15) "/www/htdocs/inc"
?>
up
5
urvi
1 year ago
about the path, there are one thing you should note :
On Windows, both slash (/) and backslash (\) are used as directory separator character. In other environments, it is the forward slash (/). (this explain is from basename() function part https://www.php.net/manual/en/function.basename.php)
example:
<?php
$path
= "https://urvidutta.com /a\b\c\filename.pdf";

echo
pathinfo($pdfUrl, PATHINFO_BASENAME); //get basename
//output
//on window: result is filename.pdf
//on Linux: result is a\b\c\filename.pdf (that is may not your expect)

//so in order to get same result in different system. i will do below first.
$path = str_replace($path, '\\', '/'); //convert '\' to '/'
?>
up
13
Pietro Baricco
12 years ago
Use this function in place of pathinfo to make it work with UTF-8 encoded file names too

<?php
function mb_pathinfo($filepath) {
preg_match('%^(.*?)[\\\\/]*(([^/\\\\]*?)(\.([^\.\\\\/]+?)|))[\\\\/\.]*$%im',$filepath,$m);
if(
$m[1]) $ret['dirname']=$m[1];
if(
$m[2]) $ret['basename']=$m[2];
if(
$m[5]) $ret['extension']=$m[5];
if(
$m[3]) $ret['filename']=$m[3];
return
$ret;
}
?>
up
10
n0dalus
19 years ago
If a file has more than one 'file extension' (seperated by periods), the last one will be returned.
For example:
<?php
$pathinfo
= pathinfo('/dir/test.tar.gz');
echo
'Extension: '.$pathinfo['extension'];
?>
will produce:
Extension: gz

and not tar.gz
To Top