BASENAME |
Base du nom |
|---|---|
| PHP 4+ | |
Syntaxe
| function basename($path); |
| function basename($path,$suffix); |
Paramètres
| Nom | Description | |
|---|---|---|
| $path | Ce paramètre permet d'indiquer le chemin de fichier à traiter. | |
| $suffix | Ce paramètre optionnel permet d'indiquer le suffixe à ne pas retourner dans la chaine de caractères. | |
Retour
| Valeur | Description |
|---|---|
| chaine de caractères | Ces valeurs permettent d'indiquer le nom de fichier. |
Description
Cette fonction permet de retourner la dernière partie d'une chemin de fichier, soit généralement le nom du fichier.
Remarques
- Extraction du nom de fichier : La fonction basename est utilisée pour extraire le nom de fichier (avec ou sans extension) à partir d'un chemin complet. Elle est pratique lorsque vous travaillez avec des chemins absolus ou relatifs et que vous avez besoin uniquement du fichier.
- Paramètre optionnel $suffix : La fonction offre un second paramètre facultatif, $suffix, permettant de retirer une extension spécifique du nom de fichier. Par exemple, basename('chemin/fichier.txt', '.txt') retourne fichier.
- Compatibilité multiplateforme : basename fonctionne aussi bien avec des chemins de fichiers sous Windows (utilisant \) qu'avec des chemins Unix/Linux (utilisant /). Elle gère correctement les différences entre ces systèmes d'exploitation.
- Gestion des chemins contenant des barres obliques finales : Si un chemin se termine par une barre oblique (par exemple, /chemin/vers/dossier/), la fonction retourne une chaîne vide, car il n'y a pas de nom de fichier. Cela peut être utile pour détecter si un chemin est un fichier ou un dossier.
- Sécurité et validation : Lorsque vous manipulez des chemins d'entrée provenant de l'utilisateur, utilisez basename pour éviter que des chemins complets ou des séquences spéciales (comme ../) ne soient accidentellement interprétés comme des emplacements système.
- Insensibilité à la casse (sur certains systèmes) : La fonction ne dépend pas de la casse des fichiers ou extensions sur les systèmes insensibles à la casse comme Windows. Cependant, sur les systèmes sensibles à la casse (Linux/Unix), cela dépend du contexte.
- Support des chaînes de caractères multioctets : À partir de PHP 7.1.0, basename prend en charge les chaînes multioctets et utilise l'encodage défini par la directive mbstring.internal_encoding si l'extension mbstring est activée. Cela améliore sa compatibilité avec des chemins utilisant des caractères non ASCII.
- Applications fréquentes : La fonction est souvent utilisée pour générer des noms de fichiers à afficher dans des interfaces utilisateur ou pour manipuler des fichiers téléchargés par des utilisateurs. Par exemple, elle peut être utilisée pour afficher uniquement le nom d'un fichier sans son chemin complet.
Voir également
Langage de programmation - PHP - Référence de procédures et fonctions - dirname
Langage de programmation - PHP - Référence de procédures et fonctions - pathinfo
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 371
Dernière mise à jour : Mercredi, le 25 mars 2015