(PHP 4, PHP 5)
dirname — Retorna o componente diretório de um caminho/path
$path
)Dada uma string contendo um caminho para um arquivo, esta função irá retornar o nome do diretório.
path
Um caminho.
No Windows, tanto barra (/) quanto a barra invertida (\) são usadas como caracter separador no path. Em outros ambientes é utilizado a barra (/).
Retorna o nome do diretório. Se não houver nenhuma barra no
path, um ponto ('.') é retornado,
indicando o diretório atual. Do contrário, a string retornada é o
path com qualquer /componente
adjacente removido.
| Versão | Descrição |
|---|---|
| 5.0.0 | dirname() passou a ser segura para binários |
| 4.0.3 | dirname() foi corrigida para estar em conformidade com a POSIX. |
Exemplo #1 exemplo do dirname()
<?php
$path = "/etc/passwd";
$file = dirname ($path); // $file = "/etc"
?>
Nota:
A partir do PHP 4.0.3, você receberá uma barra ou um ponto da dirname() em situações onde a funcionalidade anterior devolveria uma string vazia.
Confira o exemplo da mudança a seguir:
<?php
//antes do PHP 4.3.0
dirname('c:/'); // retornava '.'
//a partir do PHP 4.3.0
dirname('c:/'); // retorna 'c:'
dirname('c:/Temp/x'); // retorna 'c:/Temp'
dirname('/x'); // retorna '\'
?>