Função pathinfo

A função pathinfo retorna um array com informações sobre o caminho do arquivo. No primeiro parâmetro, passamos uma string com o caminho, e no segundo parâmetro, uma flag que indica qual componente específico do caminho deve ser retornado.

Sintaxe

phppathinfo(string $path, int $flags = PATHINFO_ALL);

Flags

Flag Descrição Elemento retornado
PATHINFO_DIRNAME Retorna apenas o diretório do arquivo dirname
PATHINFO_BASENAME Retorna apenas o nome do arquivo (com a extensão) basename
PATHINFO_EXTENSION Retorna apenas a extensão do arquivo extension
PATHINFO_FILENAME Retorna apenas o nome do arquivo (sem a extensão) filename

Exemplo

Vamos obter todas as informações sobre o caminho:

php<?php
  $res = pathinfo('/var/www/index.php');
  print_r($res);
?>

Resultado da execução do código:

php[
  'dirname' => '/var/www',
  'basename' => 'index.php',
  'extension' => 'php',
  'filename' => 'index'
]

Exemplo

Vamos obter apenas o nome do arquivo:

php<?php
  echo pathinfo('/var/www/index.php', PATHINFO_FILENAME);
?>

Resultado da execução do código:

php'index'

Exemplo

Vamos obter apenas a extensão do arquivo:

php<?php
  echo pathinfo('/var/www/index.php', PATHINFO_EXTENSION);
?>

Resultado da execução do código:

php'php'

Exemplo

Vamos obter apenas o nome do arquivo com a extensão:

php<?php
  echo pathinfo('/var/www/index.php', PATHINFO_BASENAME);
?>

Resultado da execução do código:

php'index.php'

Exemplo

Vamos obter apenas o diretório:

php<?php
  echo pathinfo('/var/www/index.php', PATHINFO_DIRNAME);
?>

Resultado da execução do código:

php'/var/www'

Veja também

  • a função realpath,
    que retorna o caminho absoluto
  • a função basename,
    que retorna o nome do arquivo
  • a função dirname,
    que retorna o nome do diretório