Função readdir

A função readdir lê o conteúdo de um diretório aberto com opendir. A cada chamada, retorna o nome do próximo arquivo ou false se não houver mais arquivos. A função mantém um ponteiro interno de posição no diretório.

Sintaxe

phpreaddir(resource $dir_handle): string|false

Exemplo

Lendo todos os arquivos em um diretório:

php<?php
  $dir = opendir('/path/to/directory');
  
  while (($file = readdir($dir)) !== false) {
    echo $file . '<br>';
  }
  closedir($dir);
?>

Resultado da execução do código (exemplo de saída):

php"file1.txt"
"file2.jpg"
"subdirectory"

Exemplo

Filtrando as entradas especiais '.' e '..':

php<?php
  $dir = opendir('.');
  
  while (($file = readdir($dir)) !== false) {
    if ($file != '.' && $file != '..') {
      echo $file . '<br>';
    }
  }
  closedir($dir);
?>

Resultado da execução do código (mostra apenas arquivos e subdiretórios reais):

php'index.php'
'styles.css'
'images'

Exemplo

Coletando todos os arquivos em um array:

php<?php
  $files = [];
  if ($handle = opendir('/path/to/dir')) {
    while (false !== ($entry = readdir($handle))) {
      if ($entry != '.' && $entry != '..') {
        $files[] = $entry;
      }
    }
    closedir($handle);
  }
  print_r($files);
?>

Resultado da execução do código:

phpArray
(
  [0] => "document.pdf"
  [1] => "image.png"
  [2] => "data.json"
)

Veja também

  • a função opendir,
    que abre um handle de diretório
  • a função scandir,
    que retorna todos os arquivos de um diretório em um array