opendir
(PHP 4, PHP 5)
opendir — Abrir un gestor de directorio
Descripción
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