dirname
(PHP 4, PHP 5)
dirname — Retorna o componente diretório de um caminho/path
Descrição
$path
)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.
Changelog
| 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
Note:
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 '\'
?>
Veja Também
- basename() - Retorna a parte nome do arquivo do caminho/path
- pathinfo() - Retorna informações sobre um caminho de arquivo
- realpath() - Retorna o path absoluto canonicalizado