(PHP 4, PHP 5)
dirname — Renvoie le nom du dossier
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 766. 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 767. 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() .