opendir

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

opendir Abre un directorio y recupera un puntero sobre él

Descripción

opendir(string $directory, ?resource $context = null): resource|false

opendir() devuelve un puntero sobre un directorio que puede ser utilizado con las funciones closedir(), readdir() y rewinddir().

Parámetros

directory

La ruta del directorio a abrir

context

Para la descripción del parámetro context, consúltese la sección de flujos del manual.

Valores devueltos

Devuelve el recurso de directorio en caso de éxito, o false en caso de error

Errores/Excepciones

En caso de fallo, se emite un E_WARNING.

Esto puede ocurrir si directory no es un directorio válido, el directorio no puede ser abierto por problemas de permisos, o debido a errores relacionados con el sistema de archivos.

Historial de cambios

Versión Descripción
8.0.0 context ahora es nullable.

Ejemplos

Ejemplo #1 Ejemplo con opendir()

<?php
$dir
= "/tmp/php5";

// Abre un directorio conocido y lista todos los ficheros
if (is_dir($dir)) {
if (
$dh = opendir($dir)) {
while ((
$file = readdir($dh)) !== false) {
echo
"fichero : $file : tipo : " . filetype($dir . $file) . "\n";
}
closedir($dh);
}
}
?>

El resultado del ejemplo sería algo similar a:

fichero : . : tipo : dir
fichero : .. : tipo : dir
fichero : apache : tipo : dir
fichero : cgi : tipo : dir
fichero : cli : tipo : dir

Ver también

  • is_dir() - Indica si el fichero es un directorio
  • readdir() - Lee una entrada del directorio
  • dir() - Devuelve una instancia de la clase Directory