Retourne le nom de la composante finale d'un chemin

Description

function basename(string $path, string $suffix = ""): string

Prend en paramètre path, le chemin d'un fichier ou d'un répertoire et en fournit le nom de la dernière composante.

Note:
basename() agit de manière naïve et n'a pas connaissance du système de fichiers sous-jacent ou des composantes d'un chemin telles que "..".

Attention

basename() est sensible à la locale, donc si le chemin possède des caractères multioctets, la locale qui convient doit être enregistrée au moyen de la fonction setlocale(). Si path contient des caractères qui sont invalides pour la locale courante, le comportement de basename() est indéfini.

Liste de paramètres

path

Un chemin.

Sous Windows, le caractère slash (/) et l'antislash (\) sont utilisés comme séparateurs de dossier. Sous les autres OS, seul le caractère slash (/) est utilisé.

suffix

Si le nom de la composante se termine par suffix, celui-ci sera aussi supprimé.

Valeurs de retour

Retourne le nom de base du chemin path donné.

Exemples

Exemple #1 Exemple avec basename()

<?php
echo "1) ".basename("/etc/sudoers.d", ".d").PHP_EOL;
echo "2) ".basename("/etc/sudoers.d").PHP_EOL;
echo "3) ".basename("/etc/passwd").PHP_EOL;
echo "4) ".basename("/etc/").PHP_EOL;
echo "5) ".basename(".").PHP_EOL;
echo "6) ".basename("/");
?>

L'exemple ci-dessus va afficher :

1) sudoers
2) sudoers.d
3) passwd
4) etc
5) .
6)

Voir aussi

dirname() - Renvoie le chemin du dossier parent
pathinfo() - Retourne des informations sur un chemin système