(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)
pathinfo — Возвращает информацию о пути к файлу
$path
, int $flags
= PATHINFO_ALL
): array|string
pathinfo() возвращает информацию о
path
в виде ассоциативного массива или
строки, в зависимости от flags
.
Замечание:
Подробнее о получении информации о текущем пути, можно почитать в разделе Предопределённые зарезервированные переменные.
Замечание:
pathinfo() оперирует входной строкой и не знает фактическую файловую систему или компоненты пути, такие как "
..
".
Замечание:
Только в системах Windows символ
\
будет интерпретироваться как разделитель каталогов. В других системах он будет рассматриваться как любой другой символ.
pathinfo() учитывает настройки локали, поэтому для корректной обработки пути с многобайтными символами должна быть установлена соответствующая локаль с помощью функции setlocale().
path
Анализируемый путь.
flags
Если указан, то задаёт, какой из элементов пути будет возвращён:
PATHINFO_DIRNAME
,
PATHINFO_BASENAME
,
PATHINFO_EXTENSION
и
PATHINFO_FILENAME
.
Если flags
не указан, то возвращаются
все доступные элементы.
Если параметр flags
не передан, то
возвращаемый ассоциативный массив (array)
будет содержать следующие элементы:
dirname
, basename
,
extension
(если есть) и filename
.
Замечание:
Если
path
содержит больше одного расширения, тоPATHINFO_EXTENSION
возвращает только последний иPATHINFO_FILENAME
удаляет только последнее расширение. (смотрите пример ниже).
Замечание:
Если
path
не содержит расширения, то не будет возвращён элементextension
(смотрите ниже второй пример).
Замечание:
Если
basename
параметраpath
начинается с точки, то все последующие символы интерпретируются как расширение файла (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(), показывающий разницу между null и отсутствием расширения
<?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() для файла, начинающегося с точки
<?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"