(PHP 4, PHP 5)
dirname — Devuelve el directorio padre de la ruta
$path
)Dada una cadena que contiene la ruta a un archivo o directorio, esta función devolverá el directorio padre de la ruta.
pathUna 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 (/).
Devuelve el nombre del 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.
| 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. |
Ejemplo #1 Ejemplo de dirname()
<?php
echo "1) " . dirname("/etc/passwd") . PHP_EOL; // 1) /etc
echo "2) " . dirname("/etc/") . PHP_EOL; // 2) / (o \ en Windows)
echo "3) " . dirname("."); // 3) .
?>
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 "..".
Nota:
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().
Nota:
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 '\'
?>