(PHP 4, PHP 5)
dirname — Renvoie le nom du dossier parent
$path
)Renvoie le chemin parent d'un chemin représentant un fichier ou un dossier.
path
Un chemin.
Sous Windows, les slash (/) et antislash (\) sont utilisés comme séparateurs de dossier. Dans les autres environnements, seul le slash (/) est utilisé.
Retourne le dossier parent du chemin. S'il n'y a pas de slash dans le chemin
path, un point ('.') sera
retourné, indiquant le dossier courant. Sinon, la chaîne retournée
sera le chemin path dont on aura supprimé tous
les /component.
| Version | Description |
|---|---|
| 5.0.0 | dirname() gère maintenant les données binaires. |
| 4.0.3 | dirname() respecte désormais la norme POSIX. |
Exemple #1 Exemple avec dirname()
<?php
echo "1) " . dirname("/etc/passwd") . PHP_EOL; // 1) /etc
echo "2) " . dirname("/etc/") . PHP_EOL; // 2) / (ou \ sous Windows)
echo "3) " . dirname("."); // 3) .
?>
Note:
dirname() agit naïvement sur la chaine en entrée et n'est pas au courant du système de fichiers courant ou d'éventuels composantes comme "..".
Note:
dirname() est sensible à la locale, donc si le chemin possède des caractères multi-octets, la locale qui convient doit être enregistrée au moyen de la fonction setlocale().
Note:
Depuis PHP 4.3.0, cette fonction retournera toujours un slash ou un point dans les cas où l'ancienne version retournait une chaîne vide.
Voici des exemples exposant ce comportement :
<?php
//Avant PHP 4.3.0
dirname('c:/'); // Retourné : '.'
//Après PHP 4.3.0
dirname('c:/x'); // Retourné : 'c:\'
dirname('c:/Temp/x'); // Retourné : 'c:/Temp'
dirname('/x'); // Retourné : '\'
?>