Главные новости

dirname

dirname

(PHP 3, PHP 4, PHP 5)

dirname -- Возвращает имя каталога из указанного пути

Описание

string dirname ( string path )

Данная функция возвращает имя каталога, содержащегося в параметре path.

На платформах Windows в качестве разделителей имен директорий используются оба слэша (прямой / и обратный\). В других операционных системах разделителем служит прямой слэш (/).


Пример 1. Пример использования функции dirname()

<?php
$paths = "/cms/templates";
$files = dirname($paths); // $files содержит "/cms"
?>

Замечание: Начиная с PHP версии 4.0.3, функция dirname() стала совместима со стандартом POSIX. Это, по существу, означает, что, если в path отсутствуют слэши, функция вернет точку ('.'), обозначающую текущий каталог. Иначе результатом выполнения функции будет являться значение параметра path с отброшенным завершающим /компонентом. Обратите внимание, что вы будете часто получать точку или слэш в ситуациях, в которых прежняя фунциональность dirname() возвращала бы пустую строку.

dirname() изменила своё поведение в PHP 4.3.0. Примеры:

<?php

//до PHP 4.3.0
dirname('d:/'); // returned '.'

//после PHP 4.3.0
dirname('d:/'); // returns 'd:'

?>

dirname() стала правильно обрабатывать двоичные данные начиная с версии PHP 5.0.0

См.также описание функций basename()pathinfo() и realpath().