dirname

(PHP 3, PHP 4 , PHP 5)

dirname -- Retorna o componente diretório de um caminho/path

Descrição

string dirname ( string path )

Dada uma string contendo um caminho para um arquivo, esta função irá retornar o nome do diretório.

No Windows, tanto barra (/) quanto a barra invertida (\) são usadas como caracter separador no path. Em outros ambientes é utilizado a barra (/).

Exemplo 1. exemplo do dirname()

<?php
$path
= "/etc/passwd";
$file = dirname ($path); // $file = "/etc"
?>

Nota: A partir do PHP 4.0.3, dirname() foi modificada para ser conformante com o POSIX. Essencialemente, isto significa que se não há barras no path, um ponto ('.') é retornado, indicando o diretório atual. Antes, a string retornada era o path com todos os /componente removidos. Ou seja, você receberá uma barra ou ponto de dirname() em situações onde a funcionalidade anterior devolveria uma string vazia.

Veja também basename(), pathinfo() e realpath().