ToWebs

Descripción

string dirname ( string path )

Dada una cadena conteniendo el path a un fichero, esta función devolverá el nombre del directorio.

En Windows, tanto la barra (/) como la barra inversa (\) son usadas como separadores de caracteres. En otros entornos, debe usarse la barra directa (/).

Ejemplo 1. Ejemplo de dirname()


<?php
$path = "/etc/passwd";
$file = dirname($path); // $file is set to "/etc"
?>

Nota: En PHP 4.0.3, dirname() fue corregida para cumplir con POSIX. Esencialmente, esto significa que si no hay diagonales en path, se regresa un punto ('.'), indicando el directorio actual. De otra manera, la cadena regresada es path con cualquier /component removido. Note que esto significa que seguido obtendrá una diagonal o punto en situaciones donde la funcionalidad anterior le haya dado una cadena vacía.

dirname() ha cambiado su comportamiento en PHP 4.3.0. Revise los siguiente ejemplos:


<?php

//before PHP 4.3.0
dirname('c:/'); // returned '.'

//after PHP 4.3.0
dirname('c:/'); // returns 'c:'

?>

dirname() es segura con datos binarios desde PHP 5.0.0

Vea también basename(), pathinfo() y realpath().