basename

(PHP 4, PHP 5)

basename — Devuelve el último componente de nombre de una ruta

Descripción

string basename ( string $path [, string $suffix ] )

Dada una cadena que contiene una ruta a un archivo o directorio, esta función devolverá el último componente de nombre.

Parámetros

path

Una ruta.

En Windows, la barra (/) y la barra invertida (\) se usan como carácter separador de directorio. En otros entornos se usa la barra hacia delante (/).

suffix

Si el nombre del componente termina en suffix éste será recortado también.

Valores devueltos

Devuelve el nombre base de path.

Ejemplos

Ejemplo #1 Ejemplo de basename()

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

El resultado del ejemplo sería:

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

Notas

Nota:

basename() opera nativamente en la entrada de cadena, y no es consciente del actual sistema de archivos, o componentes de ruta como "..".

Nota:

basename() es consciente de su sistema de localidad, así que para ver el nombre base correcto con rutas de caracteres multibyte, la localidad debe coincidir con la establecida con la función setlocale().

Ver también

  • dirname() - Devuelve el directorio padre de la ruta
  • pathinfo() - Devuelve información acerca de la ruta de un fichero