dirname
(PHP 4, PHP 5, PHP 7)
dirname — Возвращает имя родительского каталога из указанного пути
Описание
$path
, int $levels = 1
) : string
Получив строку, содержащую путь к файлу или каталогу, данная
функция возвратит родительский каталог данного пути на levels
уровней вверх.
Замечание:
Функция dirname() наивно оперирует исключительно исходной строкой и не учитывает реальную файловую систему или компоненты пути типа "
..".
dirname() учитывает настройки локали, поэтому для корректной обработки пути с многобайтовыми символами должна быть установлена соответствующая локаль с помощью функции setlocale().
Список параметров
-
path -
Путь.
На платформах Windows в качестве разделителей имен директорий используются оба слеша (прямой
/и обратный\). В других операционных системах разделителем служит прямой слеш (/). -
levels -
На сколько уровней вложенности вверх необходимо пройти.
Должно быть целым числом больше 0.
Возвращаемые значения
Возвращает путь к родительской директории. Если в параметре
path не содержится слешей, будет возвращена
точка ('.'), обозначающая текущую директорию.
В другом случае будет возвращен path
без последнего компонента /component.
Список изменений
| Версия | Описание |
|---|---|
| 7.0.0 |
Добавлен необязательный параметр levels.
|
Примеры
Пример #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
Смотрите также
- basename() - Возвращает последний компонент имени из указанного пути
- pathinfo() - Возвращает информацию о пути к файлу
- realpath() - Возвращает канонизированный абсолютный путь к файлу