(PHP 4 >= 4.0.3, PHP 5, PHP 7)
pathinfo — Retorna informações sobre um caminho de arquivo
pathinfo() retorna um array associativo
contendo inforamações sobre o caminho em path
.
path
O caminho sendo verificado.
options
Você pode especificar quais elementos são retornados com o parâmetro
opcional options
. Ele é composto de
PATHINFO_DIRNAME
,
PATHINFO_BASENAME
,
PATHINFO_EXTENSION
e
PATHINFO_FILENAME
. O padrão é retornar todos
os elementos.
Os seguintes elementos do array associativo são retornados: dirname, basename, extension (se alguma) e filename.
Se options
for utilizada, esta função retornará uma
string se todos os elementos não forem solicitados.
Versão | Descrição |
---|---|
5.2.0 |
A constante PATHINFO_FILENAME foi adicionada.
|
Exemplo #1 Exemplo de pathinfo()
<?php
$path_parts = pathinfo('/www/htdocs/index.html');
echo $path_parts['dirname'], "\n";
echo $path_parts['basename'], "\n";
echo $path_parts['extension'], "\n";
echo $path_parts['filename'], "\n"; // desde o PHP 5.2.0
?>
O exemplo acima irá imprimir:
/www/htdocs index.html html index
Nota:
Para informações de como resgatar informações do caminho atual, leia a seção de varíaveis reservadas pré-definidas.