dirname
(PHP 4, PHP 5)
dirname — Renvoie le nom du dossier
Description
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é.
Example#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 :
Example#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().