XOOPS Brasil

 

dirname

(PHP 4, PHP 5)

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

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

Exemplo #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 '\'

?>

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