dirname

(PHP 4, PHP 5)

dirname — Renvoie le nom du dossier parent

Description

string dirname ( string $path )

Renvoie le chemin parent d'un chemin représentant un fichier ou un dossier.

Liste de paramètres

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é.

Valeurs de retour

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.

Historique

Version	Description
5.0.0	dirname() gère maintenant les données binaires.
4.0.3	dirname() respecte désormais la norme POSIX.

Exemples

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) .
?>

Notes

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é : '\'

?>

Voir aussi

basename() - Retourne le nom du fichier dans un chemin
pathinfo() - Retourne des informations sur un chemin système
realpath() - Retourne le chemin canonique absolu

delete

Fonctions sur les systèmes de fichiers

disk_free_space

Manuel PHP