dirname

(PHP 4, PHP 5, PHP 7)

dirnameDevuelve la ruta de un directorio padre

Descripción

dirname ( string $path [, int $levels = 1 ] ) : string

Dada una cadena que contiene la ruta a un fichero o directorio, esta función devolverá la ruta del directorio padre que está a levels niveles del directorio actual.

Nota:

dirname() opera de forma ingénua con la cadena de entrada, y no es consciente del sistema de ficheros o los componentes de la ruta como "..".

Precaución

dirname() usa la configuración de idioma local, para poder ver de forma correcta el nombre de directorio con caracteres multibyte en la ruta, se definir la misma configuración local usando la función setlocale().

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 (/).

levels

El número de directorios padre a subir.

Debe ser un número entero mayor que 0.

Valores devueltos

Devuelve la ruta de un directorio padre. 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
7.0.0 Añadido el parámetro opcional levels.

Ejemplos

Ejemplo #1 Ejemplo de dirname()

<?php
echo dirname("/etc/passwd") . PHP_EOL;
echo 
dirname("/etc/") . PHP_EOL;
echo 
dirname(".") . PHP_EOL;
echo 
dirname("C:\\") . PHP_EOL;
echo 
dirname("/usr/local/lib"2);

El resultado del ejemplo sería algo similar a:

/etc
/ (o \ en Windows)
.
C:\
/usr

Ver también

  • basename() - Devuelve el último componente de nombre de una ruta
  • pathinfo() - Devuelve información acerca de la ruta de un fichero
  • realpath() - Devuelve el nombre de la ruta absoluta canonizado