pathinfoВозвращает информацию о пути к файлу
&reftitle.description;
arraystringpathinfostringpathintflagsPATHINFO_ALL
Функция pathinfo возвращает информацию
о пути path в виде ассоциативного массива или
строки, в зависимости от значения параметра flags.
Подробнее о получении информации о текущем пути рассказывает
раздел «Предопределённые зарезервированные переменные».
Функция pathinfo наивно оперирует входной строкой и не знает фактическую файловую систему
или компоненты пути наподобие «..».
Только в системах Windows символ \ будет интерпретироваться
как разделитель каталогов. В других системах символ будет
рассматриваться как любой другой символ.
Функция pathinfo учитывает региональные настройки, поэтому
для правильного разбора пути, который содержит многобайтовые символы, необходимо
функцией setlocale установить локаль, которая соответствует
символам пути.
&reftitle.parameters;
path
Анализируемый путь.
flags
Параметр, если установили, указывает конкретный элемент пути, который вернёт функция:
PATHINFO_DIRNAME,
PATHINFO_BASENAME,
PATHINFO_EXTENSION
и PATHINFO_FILENAME.
Если флаг flags не указали, то возвращаются
все доступные элементы.
&reftitle.returnvalues;
Если аргумент flags не передали,
возвращается ассоциативный массив (array)
со следующими элементами:
dirname, basename,
extension (если есть) и filename.
Если путь path содержит больше одного расширения,
флаг PATHINFO_EXTENSION возвращает только последнее,
а флаг PATHINFO_FILENAME только удаляет последнее расширение
(смотрите первый пример).
Если путь path не содержит расширения, функция
не вернёт элемент расширения extension (смотрите второй пример).
Если основное имя basename пути path
начинается с точки, следующие символы интерпретируются
как расширение файла (extension), а имя файла
filename как пустое (смотрите третий пример).
Если флаги flags указали, функция возвращает
строку (string), которая содержит запрошенный элемент.
&reftitle.examples;
Пример использования функции <function>pathinfo</function>
]]>
&example.outputs;
Пример работы функции <function>pathinfo</function>, который показывает разницу между null
и отсутствием расширения
]]>
&example.outputs.similar;
Пример работы функции <function>pathinfo</function> для файла,
имя которого начинается с точки
]]>
&example.outputs.similar;
/some/path
[basename] => .test
[extension] => test
[filename] =>
)
]]>
Пример использования функции <function>pathinfo</function>
с разыменованием массива
Параметр flags — не битовая маска.
Разрешается только одно значение.
Чтобы выбрать только ограниченный набор значений, которые проанализировала функция,
массив деструктурируют следующим образом:
$basename, 'dirname' => $dirname] = pathinfo('/www/htdocs/inc/lib.inc.php');
var_dump($basename, $dirname);
?>
]]>
&example.outputs.similar;
&reftitle.seealso;
dirnamebasenameparse_urlrealpath