realpath
(PHP 4, PHP 5)
realpath — Retourne le chemin canonique absolu
Description
$path
)
realpath() résout tous les liens symboliques, et
remplace toutes les références /./, /../
et / de path
puis retourne
le chemin canonique absolu ainsi trouvé.
Liste de paramètres
-
path
-
Le chemin à vérifier.
Note:
Si un chemin d'accès doit être fourni, la valeur peut être vide ou
NULL
. Dans ces cas, la valeur est interprétée comme étant le dossier courant.
Valeurs de retour
Retourne le chemin canonique absolu ainsi trouvé. Le résultat ne contient aucun lien symbolique, /./ ou /../.
realpath() retourne FALSE
si une erreur survient, e.g.
si le fichier n'existe pas.
Note:
Le script qui s'exécute doit avoir les permissions en exécution sur tous les dossiers de la structure, sinon, la fonction realpath() retournera
FALSE
.
Note: Comme le type entier de PHP est signé et que de nombreuses plates-formes utilisent des entiers de 32 bits, certaines fonctions relatives au système de fichiers peuvent retourner des résultats étranges pour les fichiers de taille supérieure à 2 Go.
Historique
Version | Description |
---|---|
5.3.0 |
Avant cette version, si le dernier composant path
n'existe pas, realpath() n'échouera pas
sous les systèmes *BSD dans ce cas.
|
5.0.0 |
Avant cette version, une valeur vide ou NULL pour le paramètre
path faisait que la fonction
realpath() retournait le nom du dossier du script.
|
Exemples
Voir aussi
- basename() - Retourne le nom du fichier dans un chemin
- dirname() - Renvoie le nom du dossier parent
- pathinfo() - Retourne des informations sur un chemin système