(PHP 4, PHP 5)
dirname — Возвращает имя каталога из указанного пути
Данная функция возвращает имя каталога, содержащегося в параметре path.
На платформах Windows в качестве разделителей имен директорий используются оба слэша (прямой / и обратный \). В других операционных системах разделителем служит прямой слэш (/).
Пример #1 Пример использования функции dirname()
<?php
$path = "/etc/passwd";
$file = dirname($path); // $file содержит "/etc"
?>
Замечание:
Начиная с PHP версии 4.0.3, функция dirname() стала совместима со стандартом POSIX. Это, по существу, означает, что, если в path отсутствуют слэши, функция вернет точку ('.'), обозначающую текущий каталог. Иначе результатом выполнения функции будет являться значение параметра path с отброшенным завершающим /компонентом. Обратите внимание, что вы будете часто получать точку или слэш в ситуациях, в которых прежняя фунциональность dirname() возвращала бы пустую строку.
dirname() изменила своё поведение в PHP 4.3.0. Примеры:
<?php
//до PHP 4.3.0
dirname('c:/'); // returned '.'
//после PHP 4.3.0
dirname('c:/'); // returns 'c:'
?>
dirname() стала правильно обрабатывать двоичные данные начиная с версии PHP 5.0.0
См.также описание функций basename(), pathinfo() и realpath().