dirname
(PHP 4, PHP 5)
dirname — Retorna o componente diretório de um caminho/path
Descrição
Dada uma string contendo um caminho para um arquivo, esta função irá retornar o nome do diretório.
Parâmetros
- 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 (/).
Valor Retornado
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.
Histórico
| 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. |
Exemplos
Example#1 exemplo do dirname()
<?php
$path = "/etc/passwd";
$file = dirname ($path); // $file = "/etc"
?>
Notas
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 '\'
?>