opendir

(PHP 4, PHP 5, PHP 7, PHP 8)

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ónDescripción
5.0.0ruta soporta dentro de la URL la envoltura ftp://.
4.3.0ruta 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
To Top