Manuel PHP
Précédent |  | Suivant

# dirname

(PHP 3, PHP 4, PHP 5)

dirname -- Renvoie le nom du dossier

## Description

string dirname ( string path )

dirname() retourne le nom du dossier qui contient le fichier ou dossier `path`.

Sous Windows, les slash (`/`) et anti-slash (`\`) sont utilisés comme séparateurs de dossier. Dans les autres environnements, seul le slash (`/`) est utilisé.

Exemple 1. Exemple avec dirname()

`<?php $path = "/etc/passwd"; $file = dirname ($path); // $file vaut "/etc" ?>`

> Note : En PHP 4.0.3, dirname() a été modifié pour être compatible POSIX. Cela signifie notamment que s'il n'y a pas de slash dans le paramètre `path`, un point ('`.`') est retourné, indiquant le dossier courant. Sinon, la chaîne retournée est `path` avec le composant final `/` supprimé. Notez que cela signifie que vous allez obtenir un slash ou un point là où l'ancien comportement de dirname() retournait une chaîne vide.

dirname() a changé de comportement en PHP 4.3.0. Voyez les exemples suivants :

Exemple 2. Différents comportements de dirname()

`<?php //avant PHP 4.3.0 dirname('c:/'); // retourne '.' //apres PHP 4.3.0 dirname('c:/'); // retourne 'c:' ?>`

dirname() a été protégé des données binaires depuis PHP 5.0.0.

Voir aussi basename(), pathinfo() et realpath().

Précédent | Sommaire | Suivant
delete | Niveau supérieur | disk_free_space