Listar directorios y subdirectorios con PHP

  • Por
Hacemos una función recursiva con PHP para listar todos los directorios y subdirectorios que cuelgan de una ruta del servidor.
En PHP existen muchas funciones para el manejo del sistema de archivos del servidor. Con su ayuda se pueden hacer fácilmente todo tipo de acciones sobre la estructura de ficheros y directorios del servidor. Hemos visto ya interesantes ejemplos sobre estas funciones en nuestro Manual de gestión de ficheros con PHP. En este taller veremos una manera de hacer un listado de los directorios que cuelgan de una carpeta dada.

La función que vamos a realizar recibe una ruta y simplemente hace un listado de los directorios que cuelgan de esa ruta. A su vez, esos directorios pueden tener otros subdirectorios dentro y estos a su vez otros, en la típica estructura de árbol. El script debe recorrer todos los subdirectorios del árbol y listarlos. Para realizar esto, lo más habitual es hacer una función recursiva, que es una función que se llama a si misma para hacer todo el trabajo.

En nuestro caso, como se decía, vamos a utilizar unas cuantas funciones de PHP para facilitarnos la tarea. Son las siguientes:

is_dir() que recibe una ruta y devuelve un boleano. True si es un directorio y flase si no lo es.

opendir() que recibe la ruta de un directorio y genera un gestor de directorio, que utilizaremos luego para extraer los subdirectorios.

readdir() recibe un gestor de directorio devuelto por opendir() y sirve para leer todo el contenido de un directorio, tanto archivos como subdirectorios. Nosotros lo utilizaremos para obtener cada uno de los subdirectorios que contiene una ruta. En la primera llamada devuelve el primer archivo o subdirectorio, en la siguiente devuelve en segundo. Es decir, cuando se vuelve a llamar devuelve siempre el siguiente fichero y continúa hasta que se acaban, devolviendo false cuando no queda ninguno.

closedir() recibe un gestor de directorio y lo cierra.

Ahora veamos la función, que está comentada.

function listar_directorios_ruta($ruta){
   // abrir un directorio y listarlo recursivo
   if (is_dir($ruta)) {
      if ($dh = opendir($ruta)) {
         while (($file = readdir($dh)) !== false) {
            //esta línea la utilizaríamos si queremos listar todo lo que hay en el directorio
            //mostraría tanto archivos como directorios
            //echo "<br>Nombre de archivo: $file : Es un: " . filetype($ruta . $file);
            if (is_dir($ruta . $file) && $file!="." && $file!=".."){
               //solo si el archivo es un directorio, distinto que "." y ".."
               echo "<br>Directorio: $ruta$file";
               listar_directorios_ruta($ruta . $file . "/");
            }
         }
      closedir($dh);
      }
   }else
      echo "<br>No es ruta valida";
}


La función recibe una ruta. Por ejemplo, si queremos que liste los directorios de la carpeta donde está el archivo la llamaríamos con:

listar_directorios_ruta("./");

Lo primero que se hace es comprobar si la ruta recibida es un directorio.

if (is_dir($ruta)) {


Si lo es realizaremos las acciones, pero si no lo es, mostraremos un mensaje diciendo que no es una ruta válida.

En el siguiente if extraemos el gestor de directorio y lo guardamos en una variable $dh

if ($dh = opendir($ruta))

Con un bucle while recorreremos cada elemento de ese directorio.

while (($file = readdir($dh)) !== false)

Dentro del bucle hacemos un if para saber si el elemento es un directorio

if (is_dir($ruta . $file) && $file!="." && $file!="..")

En caso que sea un directorio, simplemente escribimos en la página. Además, tenemos que ver si ese directorio contiene a su vez otros directorios. Para eso llamamos a la función de nuevo pasándole ese nuevo directorio. Así la función se llama a si misma para mostrar todo el árbol de carpetas.

Por último se cierra el gestor de directorio abierto previamente.

closedir($dh);

Autor

Miguel Angel Álvarez

Miguel es fundador de DesarrolloWeb.com y la plataforma de formación online EscuelaIT. Comenzó en el mundo del desarrollo web en el año 1997, transformando su hobby en su trabajo.

Compartir

Comentarios

By Mafuen

18/9/2009
Gracias por el articulo - By Mafuen
Agradezco la limpieza del ejemplo..., y recalco lo complicado que es entender los ejemplos gringos de la pagina de php..., gracias de nuevo..

alvaro

11/3/2010
no me funciona
pongo elcodigo y no me muestra nada, ni siquiera un error en que no me he fijado?
gracias

Diego Celta

12/3/2010
Excelente Funcion
Muchas Gracias, una funcion excelente, funciona a a perfeccion.

LEYDI

18/4/2010
PORQUE
PORQUE TODOS SON AZI
JSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSOWOWOOOOW``´ÑD.CL,VFKFKKKKKKKKKKKJCHNNVHUCHJ KDU JIUYSH

Roberto Carlos

04/6/2011
Ayuda
Necesito una luz..... le hice algunos arreglitos a este mismo ejemplo, pues lo ke necesito no ke me de la ruta, sino construir un árbol de directorios y mostrarlo usando ExtJS.... estuve probando en php solo y cuando le hago el llamado con un directorio que tiene 609 ARCHIVOS Y 85 CARPETAS me muestra este error cuando va por la carpeta 81!!!!! ¿alguien con una idea? ¿algún divide y vencerás?

Fatal error: Maximum execution time of 30 seconds exceeded in C:AppServwwwlolo.php on line 10

ahah: la línea 10 es esta:
if (is_dir($ruta.$file) && $file != "." && $file != "..")

omar

17/2/2012
funciona el opendir con ftp??..
la idea es abrir el directorio pero que esta alojado por un servidor ftp. opendir funciona.. tengo entendido que hay unos eorrres y warning que genera.. queria consultarles si es posible o debo utilizar otras formas

gracias

christian

23/2/2012
Cambio
agregue unos cambios para q funcione sobre linux


function listar_directorios_ruta($ruta){
// abrir un directorio y listarlo recursivo
if (is_dir($ruta)) {
if ($dh = opendir($ruta)) {
while (($file = readdir($dh)) !== false) {
//esta línea la utilizaríamos si queremos listar todo lo que hay en el directorio
//mostraría tanto archivos como directorios
echo "<br>Nombre de archivo: $file ";
if (is_dir($ruta . "/" . $file) && $file!="." && $file!=".."){
//solo si el archivo es un directorio, distinto que "." y ".."
echo "<br>Directorio: $ruta$file";
listar_directorios_ruta($ruta ."/". $file . "/");
}
}
closedir($dh);
}
}else
echo "<br>No es ruta valida";
}

Francisco

20/4/2012
No sirve
que pérdida de tiempo. . .

Francisco

20/4/2012
Disculpas
Si funciona, el problema estaba en mi servidor, luego de reinstalarlo funciono. Disculpas de nuevo.

Javier

02/6/2012
Pequeña corrección
Algunos cambios para que funcione :

function listar_directorios_ruta($ruta){
// abrir un directorio y listarlo recursivo
if (is_dir($ruta)) {
if ($dh = opendir($ruta)) {
while (($file = readdir($dh)) !== false) {
//esta línea la utilizaríamos si queremos listar todo lo que hay en el directorio
//mostraría tanto archivos como directorios
//echo "<br>Nombre de archivo: $file : Es un: " . filetype($ruta . $file);
if (is_dir("$ruta/$file") && $file!="." && $file!=".."){
//solo si el archivo es un directorio, distinto que "." y ".."
echo "<br>Directorio: $ruta/$file";
listar_directorios_ruta("$ruta/$file");
}
}
closedir($dh);
}
}else
echo "<br>No es ruta valida";
}

Theasker

17/7/2012
dudas de funcionamiento
Felicidades por la función, me funciona perfectamente y la entiendo muy bien, yo la estaba intentando crear por mi cuenta y sabía que tenia que usar una función recursiva, pero ... lo que no acabo de entender bien y es por lo que no lo he sacado por mi mismo es que a la hora de asignar la identificación al abrir el directorio(if ($dh = opendir($ruta)) {...), xq si sobreescribe la informaciónq ue había cuando cierra el directorio y vuelve al anterior se mantiene la información.

No entiendo muy bien como sobreescribiendo la información de la variable, luego posteriormente sigue la información antigua del directorio anterior, incluso de varios niveles.

Gracias anticipadas por tu ayuda

31341303P

24/4/2013
Mostrar lista de archivos y directorios
El código me funciona perfectamente. Gracias, el tiempo ahorrado es mucho. Además es un código muy bien expuesto.

jhon

13/6/2013
Codigo Apertura De Directorios(PHP)
Gracias por la publicación. Ha sido de mucha ayuda.

Maria

05/11/2013
Guardar el resultado
Hola, ¿cómo se podría guardar el resultado en un objeto por ejemplo en un objeto json?
Muchas gracias. Un saludo.

angel

27/6/2014
Cambio de codigo
le falto un $this-> para que haga la recursividad

function listar_directorios_ruta($ruta){
// abrir un directorio y listarlo recursivo
if (is_dir($ruta)) {
if ($dh = opendir($ruta)) {
while (($file = readdir($dh)) !== false) {
//esta línea la utilizaríamos si queremos listar todo lo que hay en el directorio
//mostraría tanto archivos como directorios
echo "<br>&nbsp;Nombre de Archivo: $file : Es un: " . filetype($ruta."/".$file);
if (is_dir("$ruta/$file") && $file!="." && $file!=".."){
//solo si el archivo es un directorio, distinto que "." y ".."
echo "<br><br>Directorio: $ruta/$file";
$this->listar_directorios_ruta("$ruta/$file");
}
}
closedir($dh);
}
}else
echo "<br>No es ruta valida";
}