Funciones del Sistema de Archivos
PHP Manual

dirname

(PHP 4, PHP 5)

dirnameDevuelve el componente nombre de directorio de la ruta

Descripción

string dirname ( string $path )

Dada una cadena que contiene una ruta a un archivo, esta función devolverá el nombre del directorio.

Parámetros

path

Una ruta.

En Windows, la barra (/) y la barra invertida (\) se usan como carácter separador de directorio. En otros entornos se usa la barra hacia delante (/).

Valores devueltos

Devuelve el nombre del directorio. Si no hay barras en path, será devuelto un punto ('.'), indicando el directorio actual. De otro modo, la cadena devuelta es path con cualquier /componente final eliminado.

Historial de cambios

Versión Descripción
5.0.0 dirname() ahora es segura al trabajar con datos binarios
4.0.3 dirname() fue corregida para soportar POSIX.

Ejemplos

Example #1 Ejemplo de dirname()

<?php
$ruta 
"/etc/passwd";
$archivo dirname($ruta); // $archivo es establecido a "/etc"
?>

Notas

Note:

A partir de PHP 4.3.0, a menudo querrá obtener una barra o un punto de dirname() es situaciones donde la funcionalidad anterior le habría dado una cadena vacía.

Revise el siguiente cambio de ejemplo:

<?php

//antes de PHP 4.3.0
dirname('c:/'); // devolvía '.'

//después de PHP 4.3.0
dirname('c:/x'); // devuelve 'c:\'
dirname('c:/Temp/x'); // devuelve 'c:/Temp'
dirname('/x'); // devuelve '\'

?>

Ver también


Funciones del Sistema de Archivos
PHP Manual