opendir

(PHP 3, 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ónDescripció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

Ejemplo 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

Ver también

is_dir()
readdir()
Dir

Hosting by: hurra.com
Generated: 2007-01-26 18:00:48