RecursiveDirectoryIterator::__construct

(PHP 5 >= 5.1.2, PHP 7, PHP 8)

RecursiveDirectoryIterator::__construct — Construye un RecursiveDirectoryIterator

Descripción

public RecursiveDirectoryIterator::__construct(string $path, int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO)

Construye un RecursiveDirectoryIterator() para el path proporcionado.

Parámetros

path: La ruta de el directorio a ser iterado.
flags: Se pueden proporcionar flags para afectar el comportamiento de algunos métodos. Una lista de flags puede encontrarse en Constantes predefinidas FilesystemIterator. También se pueden establecer más tarde con FilesystemIterator::setFlags().

Valores devueltos

Devuelve el RecursiveDirectoryIterator recién creado.

Errores/Excepciones

Lanza una UnexpectedValueException si el path no puede ser encontrado o este no es un directorio.

Ejemplos

Ejemplo #1 Ejemplo de RecursiveDirectoryIterator

<?php

$directorio = '/tmp';

$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($directorio));

$it->rewind();
while($it->valid()) {

    if (!$it->isDot()) {
        echo 'SubPathName: ' . $it->getSubPathName() . "\n";
        echo 'SubPath:     ' . $it->getSubPath() . "\n";
        echo 'Key:         ' . $it->key() . "\n\n";
    }

    $it->next();
}

?>

El resultado del ejemplo sería algo similar a:

SubPathName: fruta/manzana.xml
SubPath:     fruta
Key:         /tmp/fruta/manzana.xml

SubPathName: stuff.xml
SubPath:     
Key:         /tmp/stuff.xml

SubPathName: vegetales/zanahoria.xml
SubPath:     vegetales
Key:         /tmp/vegetales/zanahoria.xml

Ver también

FilesystemIterator::__construct() - Construye un nuevo iterador filesystem
RecursiveIteratorIterator::__construct() - Construir un objeto RecursiveIteratorIterator
Constantes predefinidas FilesystemIterator

＋add a note

User Contributed Notes 2 notes

down

pedro dot matamouros at gmail dot com ¶

13 years ago

You can use RecursiveDirectoryIterator::FOLLOW_SYMLINKS as a flag to the constructor to have RecursiveDirectoryIterator follow symlinks, which it does not do by default.



[EDIT BY danbrown AT php DOT net on 16-JUL-2012: Contains a typofix provided by (lightrekky AT gmail DOT com) in note #109280 on 02-JUL-2012.]

down

hanskrentel at yahoo dot de ¶

11 years ago

The two default flags are zero (virtual) as with my PHP versions (5.3 and 5.4). Which means you can not check if those are set or not with the & bitwise operator:

<?php
// CURRENT_AS_FILEINFO (0)
// KEY_AS_PATHNAME (0)

### always FALSE ###
$directoryIterator->getFlags() & RecursiveDirectoryIterator::CURRENT_AS_FILEINFO;

?>

But this also allows that you can use other flags right ahead without repeating the default ones:

<?php
new RecursiveDirectoryIterator(
    '.', 
    FilesystemIterator::UNIX_PATHS
);
?>

There is no need to repeat the default flags. Please note that this is different to FilesystemIterator which has as well the SKIP_DOTS flag as default which is non-zero:

<?php
new RecursiveDirectoryIterator(
    '.', 
    FilesystemIterator::SKIP_DOTS
        | FilesystemIterator::UNIX_PATHS
);
?>

＋add a note