opendir

(PHP 4, PHP 5, PHP 7)

opendirAbre un gestor de directorio

Descripción

opendir ( string $path [, resource $context ] ) : resource

Abre un gestor de directorio para ser usado con llamadas posteriores como closedir(), readdir(), y rewinddir().

Parámetros

ruta

La ruta del directorio a ser abierta.

contexto

Para una descripción del parámetro contexto, refiérase a la sección de secuencias del manual.

Valores devueltos

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

Si ruta 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.

Historial de cambios

Versión Descripción
5.0.0 ruta soporta dentro de la URL la envoltura 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 opendir() ejemplo

<?php
$dir 
"/etc/php5/";
 
// Abre un directorio conocido, y procede a leer el contenido
if (is_dir($dir)) {
    if (
$dh opendir($dir)) {
        while ((
$file readdir($dh)) !== false) {
            echo 
"nombre archivo: $file : tipo archivo: " filetype($dir $file) . "\n";
        }
        
closedir($dh);
    }
}
?>

El resultado del ejemplo sería algo similar a:

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

Ver también

  • is_dir() - Indica si el nombre de archivo es un directorio
  • readdir() - Lee una entrada desde un gestor de directorio
  • dir() - Devuelve una instancia de la clase Directory