dirname

Manuel PHP
Précédent		Suivant

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