array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.dirname.php', 1 => 'dirname', 2 => 'Возвращает путь к родительскому каталогу', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.delete.php', 1 => 'delete', ), 'next' => array ( 0 => 'function.disk-free-space.php', 1 => 'disk_free_space', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/dirname.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

dirname

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

dirname — Возвращает путь к родительскому каталогу

Описание

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

Функция получит строку, которая содержит путь к файлу или каталогу, и вернёт путь к родительскому каталогу на столько уровней выше текущего каталога, сколько указали в параметре levels.

Замечание:

Функция dirname() наивно работает со входной строкой и не знает действительную файловую систему или компоненты пути наподобие «..».

Предостережение

В ОС Windows функция dirname() принимает установленную кодовую страницу. Поэтому, чтобы функция видела правильное имя каталога, путь которого содержит многобайтовые символы, требуется устанавливать кодовую страницу, которая соответствует кодировке этих символов. Функция dirname() поведёт себя непредсказуемо, если имя пути path содержит неправильные для текущей кодовой страницы символы.

В других системах функция dirname() предполагает, что путь path закодировали в ASCII-совместимой кодировке, иначе функция ведёт себя непредсказуемо.

Список параметров

path

Путь.

На платформах Windows как разделитель имён каталогов работает и прямой /, и обратный \ слеш. В других окружениях — прямой слеш /.

levels

На сколько уровней вложенности вверх требуется пройти.

Значение должно быть целым числом больше 0.

Возвращаемые значения

Функция возвращает путь к родительской директории. Функция возвращает точку «.», которая указывает на текущую директорию, если путь path не содержит слешей, иначе возвращает путь path без последнего компонента /component.

Предостережение

При работе с функцией в цикле соблюдают осторожность, поскольку при достижении каталога верхнего уровня функция войдет в бесконечный цикл.

<?php

dirname('.'); // Вернёт «.».
dirname('/'); // Вернёт «\» в ОС Windows и «/» в *nix-системах.
dirname('\\'); // Вернёт «\» в ОС Windows и «.» в *nix-системах.
dirname('C:\\'); // Вернёт «C:\» в ОС Windows и «.» в *nix-системах.

?>

Примеры

Пример #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
/ (или \ в Windows)
.
C:\
/usr

Смотрите также