Manuel PHP
PrécédentSuivant

dirname

(PHP 3, PHP 4 , PHP 5)

dirname -- Renvoie le nom du dossier

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édentSommaireSuivant
deleteNiveau supérieurdisk_free_space