opendir

(PHP 4, PHP 5)

opendir — Abrir un gestor de directorio

Descripción

resource opendir ( string $ruta [, resource $contexto ] )

Abre un gestor de directorio a ser usado en llamadas posteriores a closedir(), readdir(), y rewinddir().

Lista de parámetros

ruta: La ruta del directorio a ser abierto
contexto: Para una descripción del parámetro contexto , refiérase a la sección de secuencias del manual.

Valores retornados

Devuelve un gestor de directorio tipo resource en caso de éxito, o FALSE si ocurre un error.

Si path no es un directorio válido o el directorio no puede ser abierto debido a restricciones de permisos o errores del sistema de archivos, opendir() devuelve FALSE y genera un error de PHP de nivel E_WARNING. Es posible suprimir la salida del error de opendir() anteponiendo '@' al nombre de la función.

Registro de cambios

Versión Descripción

5.0.0 ruta soporta la envoltura de URL ftp://.

4.3.0 ruta puede leer también cualquier URL que soporte el listado de directorios, sin embargo solo la envoltura de URL file:// tiene este soporte en PHP 4

Ejemplos

Example #1 Ejemplo de opendir()

<?php
$dir = "/etc/php5/";

// Abrir un directorio conocido, y proceder a leer sus contenidos
if (is_dir($dir)) {
    if ($gd = opendir($dir)) {
        while (($archivo = readdir($gd)) !== false) {
            echo "nombre de archivo: $archivo : tipo de archivo: " . filetype($dir . $archivo) . "\n";
        }
        closedir($gd);
    }
}
?>

El resultado del ejemplo seria algo similar a:

nombre de archivo: . : tipo de archivo: dir
nombre de archivo: .. : tipo de archivo: dir
nombre de archivo: apache : tipo de archivo: dir
nombre de archivo: cgi : tipo de archivo: dir
nombre de archivo: cli : tipo de archivo: dir