Manual do PHP
Anterior |  | Próxima

# 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.

dirname() mudou o seu funcionamento no PHP 4.3.0. Confira os exemplos a seguir:

`<?php //before PHP 4.3.0 dirname('c:/'); // retornava '.' //after PHP 4.3.0 dirname('c:/'); // retorna 'c:' ?>`

dirname() é seguro para binários desde PHP 5.0.0

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

Anterior | Principal | Próxima
delete | Acima | disk_free_space