FilesystemIterator::__construct
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
FilesystemIterator::__construct — Constrói um novo iterador de sistema de arquivos
Descrição
$directory, int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS)
Constrói um novo iterador de sistema de arquivos a partir do directory.
Parâmetros
-
directory -
O caminho do item do sistema de arquivos a ser iterado.
-
flags -
As opções podem ser fornecidas e afetarão o comportamento de alguns métodos. Uma lista das opções pode ser encontrada em Constantes pré-definidas do FilesystemIterator. Elas também podem ser definidas posteriormente com FilesystemIterator::setFlags()
Erros/Exceções
Lança uma UnexpectedValueException
se o directory não existir.
Lança um ValueError
se o directory for uma string vazia.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.2.0 |
Antes do PHP 8.2.0, FilesystemIterator::SKIP_DOTS era
sempre definido e não podia ser removido.
|
| 8.0.0 |
Agora lança um ValueError se
directory for uma string vazia;
anteriormente lançava um RuntimeException.
|
Exemplos
Exemplo #1 Exemplo de FilesystemIterator::__construct()
<?php
$it = new FilesystemIterator(dirname(__FILE__), FilesystemIterator::CURRENT_AS_FILEINFO);
foreach ($it as $fileinfo) {
echo $fileinfo->getFilename() . "\n";
}
?>A saída do exemplo acima no PHP 8.2 é semelhante a:
. .. apples.jpg banana.jpg example.php
A saída do exemplo acima antes do PHP 8.2.0 é semelhante a:
apples.jpg banana.jpg example.php
Veja Também
- FilesystemIterator::setFlags() - Define opções de manipulação
- DirectoryIterator::__construct() - Constrói um novo iterador de diretório a partir de um caminho
add a note
