dirname
(PHP 4, PHP 5)
dirname — Devuelve el directorio padre de la ruta
Descripción
$path
)Dada una cadena que contiene la ruta a un archivo o directorio, esta función devolverá el directorio padre de la ruta.
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 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 |
|---|---|
| 5.0.0 | dirname() ahora es segura al trabajar con datos binarios |
Ejemplos
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) .
?>
Notas
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 '\'
?>
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