Gestión de directorios por PHP

21 de octubre de 2002
Valoración del artículo:
Aprendemos a navegar por la arborescencia de directorios del sistema de archivos del servidor.
Atención: Contenido exclusivo de DesarrolloWeb.com. No reproducir. Copyright.
Siguiendo con la saga de artículos referentes a la explotación de archivos por medio de PHP, vamos a presentar algunas funciones que nos pueden ser muy útiles en la navegación por directorios. Este tipo de funciones podrían, por ejemplo, servirnos para crear exploradores de archivos en nuestro navegador.

Funciones de gestión de directorios
Función Descripción Sintaxis
opendir Abre un directorio situado en $path y le asigna un identificador $dir $dir = opendir($path)
readdir Lee un elemento del directorio $dir abierto previamente con opendir y desplaza el puntero al elemento siguiente readdir($dir)
rmdir Elimina el directorio $dir rmdir($dir)
mkdir Crea un directorio situado en $path con los derechos de acceso $derechos (entero) mkdir($path, $derechos)
rewinddir Vuelve el puntero de lectura del directorio $dir al primer elemento rewinddir($dir)
closedir Cierra el directorio $dir abierto previamente con opendir closedir($dir)

La forma de tratar con estas funciones es la similar a la que ya hemos visto para le lectura secuencial de archivos. Podemos distinguir tres etapas elementales:
  • Apertura del directorio por medio de la función opendir asignándole al mismo tiempo un identificador
  • Realización de las tareas necesarias en relación con ese directorio
  • Clausura del identificador por medio de la función closedir
A notar que, para que un directorio pueda ser borrado, hace falta previamente haber eliminado cada uno de los elementos contenidos dentro del directorio. Para esto, nos podemos servir de la función unlink, presentada en otor artículo.

Por otra parte, la creación de un directorio por medio de la función mkdir requiere la definición de los derechos de acceso por medio de un numero entero. Esperamos poder explicar en qué consisten estos derechos próximamente.

Como ejemplo sencillo de lo que podemos hacer con estas funciones, aquí os presentamos un pequeño script de lectura que os permite visualizar el contenido de un directorio:

<?
//definimos el path de acceso
$path = "mi/camino";

//abrimos el directorio
$dir = opendir($path);

//Mostramos las informaciones
while ($elemento = readdir($dir))
{
   echo $elemento."<br>";
}

//Cerramos el directorio
closedir($dir);
?>

Otra forma de abordar la gestión de directorios es por medio de la clase dir que permite la creación de un objeto sobre el cual podremos aplicar toda una serie de métodos equivalentes a las funciones previamente vistas. Si estas familiarizado con la programación orientada a objetos, puede que esta modalidad te resulte mas intuitiva. Si no sabes en qué consiste la programación orientada a objetos, puedes visitar este artículo.

En este caso, la forma de operar es análoga a la ya vista:
  • Creamos un objeto $dir con la instrucción: $dir = dir($path)
  • Realizamos las tareas necesarias llamando a los métodos de la clase dir
  • Cerramos el directorio con el método close
Algunos de los métodos que podemos utilizar con esta clase son los siguientes:

Métodos de la clase dir
Método Descripción Sintaxis
path Indica el path del directorio $objeto->path
read Lee un elemento del directorio $objeto->read
rewind Vuelve el puntero de lectura del directorio al primer elemento $objeto->rewind
close Cierra el directorio $objeto->close

Como ejemplo, he aquí el script equivalente al abordado para el caso de las funciones, esta vez usando la clase dir:

<?
//definimos el path de acceso
$path="mi/camino/";

//instanciamos el objeto
$dir=dir($path);

//Mostramos las informaciones
echo "Directorio ".$dir->path.":<br><br>";

while ($elemento = $dir->read())
{
   echo $elemento."<br>";
}
//Cerramos el directorio
$dir->close();
?>

Los scripts propuestos no son más que ejemplos sencillos de lo que estas funciones pueden ofrecernos. En vuestras manos queda el combinar estas funciones con otras vistas en este mismo taller de manera a crear aplicaciones que gestionen los archivos y directorios de vuestro servidor.

Recordamos que esta lista no es más que una recopilación y que muchas otras funciones relacionadas pueden sernos también útiles.

Comentarios
Fueron enviados 5 comentarios al artículo
1 comentario no revisado
4 comentarios revisados:
Por: Marketeam
01/10/04
En el articulo aparece el siguiente link http://www.php.net/manual/en/ref.filesystem.php que es para entrar a la versión en ingles. Para ver la versión en español es necesario cambiar el "en" por "es" (http://www.php.net/manual/es/ref.filesystem.php)
Espero que les sirva
Por: Greco2
24/7/06
Hola, yo necesitaba tambien una funcion o algo que me verifique si el directorio existe y evitar crearlo y lo que hice fue lo siguiente:

<?php
$dir="chat2";
if (!is_dir($dir)){
@mkdir($dir, 0777);
echo "se creo el directorio: ".$dir;
}else{
echo "existe el directorio: ".$dir;
}
?>

lo probe y funciona perfecto, espero les sirva.
Por: Greco2
24/7/06
estuve mirando por ahi y creo que seria mejor comprovar la existencia de un directorio de esta forma y no como lo puse en el mensaje anterior:

<?php
$dir="nombre_dir";
if (!file_exists($dir)){
@mkdir($dir, 0777);
echo "se creo el directorio: ".$dir;
}else{
echo "existe el directorio: ".$dir;
}
?>
usando file_exist y no is_dir

soy novato asi que me equivoque pero en todo caso tambien funciona :)

1885
Manejo de archivos local y en red es lo mismo?
16/12/09
declarar variables como $path y $fopen serviran para abrir cualquier archivo? , se usan solo para aplicaciones locales? o incluso en una red wan?sera capas php de crear una aplicacion como ftp o para manejar un hosting?
si alguien tiene por lo menos una respuesta favor de publicarla o responder a este comentario

Manuales relacionados
Categorias relacionadas
El autor
Rubén Alvarez
Redactor de DesarrolloWeb.com
http://www.desarrolloweb.com
Últimas noticias
Alojados en el grupo