array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.basename.php', 1 => 'basename', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções do sistema de arquivos', ), 'prev' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções do sistema de arquivos', ), 'next' => array ( 0 => 'function.chgrp.php', 1 => 'chgrp', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/filesystem/functions/basename.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
basename — Retorna a última parte do caminho
Dada uma string contendo o caminho para um arquivo ou diretório, esta função retornará a última parte do caminho.
Nota:
A função basename() opera de forma ingênua na string fornecida e não tem conhecimento do sistema de arquivos real ou dos componentes de caminho como "
..
".
A função basename() reconhece a localidade, portanto,
para obter o nome correto ao usar caminhos com caracteres multibyte,
a localidade correspondente deve ser definida com a função
setlocale(). Se o parâmetro path
contiver caracteres inválidos
para a localidade atual, o comportamento de basename() será indefinido.
path
Um caminho.
No Windows, tanto a barra (/
) quanto a barra invertida
(\
) são usadas como caractere separador de diretório.
Em outros ambientes, apenas a barra (/
) é usada.
suffix
Se a última parte do caminho terminar em suffix
,
ele será removido.
Retorna a última parte de um dado path
.
Exemplo #1 Exemplo de 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("/");
?>
O exemplo acima produzirá:
1) sudoers 2) sudoers.d 3) passwd 4) etc 5) . 6)