pathinfo
(PHP 4 >= 4.0.3, PHP 5)
pathinfo — Retorna informações sobre um caminho de arquivo
Descrição
pathinfo() retorna um array associativo
contendo inforamações sobre o caminho em path.
Parâmetros
-
path -
O caminho sendo verificado.
-
options -
Você pode especificar quais elementos são retornados com o parâmetro opcional
options. Ele é composto dePATHINFO_DIRNAME,PATHINFO_BASENAME,PATHINFO_EXTENSIONePATHINFO_FILENAME. O padrão é retornar todos os elementos.
Valor Retornado
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.
Changelog
| Versão | Descrição |
|---|---|
| 5.2.0 |
A constante PATHINFO_FILENAME foi adicionada.
|
Exemplos
Example #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
Notas
Note:
Para informações de como resgatar informações do caminho atual, leia a seção de varíaveis reservadas pré-definidas.
Veja Também
- dirname() - Retorna o componente diretório de um caminho/path
- basename() - Retorna a parte nome do arquivo do caminho/path
- parse_url() - Interpreta uma URL e retorna os seus componentes
- realpath() - Retorna o path absoluto canonicalizado