(PHP 4, PHP 5, PHP 7, PHP 8)
opendir — Abre un gestor de directorio
Abre un gestor de directorio para ser usado con llamadas posteriores como closedir(), readdir(), y rewinddir().
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.
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.
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 . |
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