Função dirname

A função dirname retorna o caminho para o diretório pai do caminho especificado. O primeiro parâmetro da função é uma string com o caminho, e o segundo parâmetro opcional - o número de níveis para subir na hierarquia.

Sintaxe

phpdirname(string $path, int $levels = 1): string

Exemplo

Obtendo o diretório pai para o caminho:

php<?php
  echo dirname('/var/www/html/index.php');
?>

Resultado da execução do código:

php'/var/www/html'

Exemplo

Subindo dois níveis na hierarquia de diretórios:

php<?php
  echo dirname('/var/www/html/index.php', 2);
?>

Resultado da execução do código:

php'/var'

Exemplo

Trabalhando com caminhos relativos:

php<?php
  echo dirname('images/photo.jpg');
?>

Resultado da execução do código:

php'images'

Veja também

  • a função basename,
    que retorna o nome do arquivo
  • a função pathinfo,
    que retorna informações sobre o caminho
  • a função realpath,
    que retorna o caminho absoluto