dirname - Возвращает имя родительского каталога из указанного пути
Вернуться к: Файловая система
dirname
(PHP 4, PHP 5, PHP 7)
dirname — Возвращает имя родительского каталога из указанного пути
Описание
$path
)Получив строку, содержащую путь к файлу или каталогу, данная функция возвратит родительский каталог данного пути.
Список параметров
-
path -
Путь.
На платформах Windows в качестве разделителей имен директорий используются оба слеша (прямой / и обратный \). В других операционных системах разделителем служит прямой слеш (/).
Возвращаемые значения
Возвращает путь к родительской директории. Если в параметре
path не содержится слешей, будет возвращена
точка ('.'), обозначающая текущую директорию.
В другом случае будет возвращен path
без последнего компонента /component.
Список изменений
| Версия | Описание |
|---|---|
| 5.0.0 | dirname() теперь безопасна для обработки бинарных данных. |
Примеры
Пример #1 Пример использования функции dirname()
<?php
echo "1) " . dirname("/etc/passwd") . PHP_EOL; // 1) /etc
echo "2) " . dirname("/etc/") . PHP_EOL; // 2) / (или \ на Windows)
echo "3) " . dirname("."); // 3) .
?>
Примечания
Замечание:
Функция dirname() наивно оперирует исключительно исходной строкой и не учитывает реальную файловую систему или компоненты пути типа "..".
Замечание:
dirname() учитывает настройки локали, поэтому для корректной обработки пути с многобайтными символами должна быть установлена соответствующая локаль с помощью функции setlocale().
Замечание:
Начиная с версии PHP 4.3.0, функция dirname() вернет слеш или точку там, где ранее возвращалась бы пустая строка.
Посмотрите следующий пример, иллюстрирующий эти изменения:
<?php
//до PHP 4.3.0
dirname('c:/'); // возвращала '.'
//после PHP 4.3.0
dirname('c:/x'); // возвращает 'c:\'
dirname('c:/Temp/x'); // возвращает 'c:/Temp'
dirname('/x'); // возвращает '\'
?>
Смотрите также
- basename() - Возвращает последний компонент имени из указанного пути
- pathinfo() - Возвращает информацию о пути к файлу
- realpath() - Возвращает канонизированный абсолютный путь к файлу
Вернуться к: Файловая система