(PHP 4, PHP 5, PHP 7, PHP 8)
opendir — Abre um manipulador de diretório
Abre um manipulador de diretório para ser usado em chamadas subsequentes de closedir(), readdir() e rewinddir().
directorycontextcontext,
consulte a seção sobre fluxos do
manual.
Retorna um manipulador de diretório em caso de sucesso,
ou false em caso de falha
Em caso de falha, um E_WARNING será emitido.
Isto pode ocorrer se directory não for um nome de diretório válido,
o diretório não puder ser aberto por restrições de permissão,
ou por erros no sistema de arquivos.
| Versão | Descrição |
|---|---|
| 8.0.0 |
context agora pode ser nulo.
|
Exemplo #1
Lista todas as entradas de um diretório, pulando os especiais .
e ..
Como os nomes de diretório e arquivo podem ser strings interpretadas como "falso" pelo PHP
(por exemplo um diretório com nome "0") e
readdir() retorna false quando tiver lido todas as entradas
em um diretório, deve-se usar o operador de comparação
===
para distinguir adequadamente entre uma entrada de diretório cujo nome seja interpretado como "falso" e
a função ter terminado de ler todas as entradas.
<?php
if ($handle = opendir('/path/to/files')) {
echo "Entradas:\n";
/* Lidando corretamente com entradas de diretório que podem ser interpretadas como "falso" */
while (false !== ($entry = readdir($handle))) {
if ($entry === '.' || $entry === '..') {
continue;
}
echo "$entry\n";
}
closedir($handle);
}
?>O exemplo acima produzirá algo semelhante a:
Entradas: base en fr output.md test.php