realpath()
Introduction
En PHP, la fonction realpath() permet de résoudre le chemin absolu d'un fichier ou d'un répertoire. Elle est particulièrement utile pour normaliser les chemins et résoudre les liens symboliques. Cet article couvre sa syntaxe, son comportement et des exemples pratiques.
Comprendre la fonction realpath()
La fonction realpath() prend une chaîne de chemin en entrée et renvoie le chemin absolu canonique. Elle résout automatiquement les segments . et .., supprime les barres obliques finales et suit les liens symboliques vers leurs cibles réelles. Si le chemin spécifié n'existe pas ou ne peut pas être résolu, la fonction renvoie false.
Syntaxe de la fonction realpath()
La syntaxe de la fonction realpath() est la suivante :
realpath($path);Ici, $path correspond au chemin du fichier ou du répertoire. La fonction renvoie le chemin absolu résolu sous forme de chaîne, ou false en cas d'échec.
Exemples d'utilisation de realpath()
Examinons quelques exemples d'utilisation de la fonction realpath() en PHP.
Exemple 1 : Résolution du chemin absolu d'un fichier
<?php
$file_path = 'example.txt';
$absolute_path = realpath($file_path);
if ($absolute_path !== false) {
echo $absolute_path;
} else {
echo "File not found.";
}Cet exemple résout le chemin absolu du fichier example.txt et gère de manière sécurisée les cas où le fichier n'existe pas.
Exemple 2 : Résolution du chemin absolu d'un répertoire
<?php
$dir_path = 'example_directory';
$absolute_path = realpath($dir_path);
if ($absolute_path !== false) {
echo $absolute_path;
} else {
echo "Directory not found.";
}Dans cet exemple, le chemin absolu du répertoire example_directory est résolu à l'aide de realpath() et inclut une gestion d'erreur basique pour les répertoires manquants.
Conclusion
La fonction realpath() est un outil fiable pour normaliser les chemins et résoudre les liens symboliques en PHP. En vérifiant les retours false, vous pouvez vous assurer que vos scripts gèrent les fichiers ou répertoires manquants de manière élégante. Utilisez-la pour mettre en place une gestion des chemins plus robuste dans vos projets.
Pratique
Quelle est la fonction de realpath() en PHP ?