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 (/).
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 opath
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 |
dirname() é seguro para binários desde PHP 5.0.0
Veja também basename(), pathinfo() e realpath().