delete
disk_free_space
Funções para Sistema de arquivo
PHP Manual

# dirname

(PHP 4, PHP 5)

dirname — Retorna 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.

### 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

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

delete
disk_free_space
Funções para Sistema de arquivo
PHP Manual