FilesystemIterator::__construct

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

    FilesystemIterator::__construct — Constructs a new filesystem iterator

    Beschreibung

    publicFilesystemIterator::__construct(string$directory, int$flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS)

    Constructs a new filesystem iterator from the directory.

    Parameter-Liste

    directory

    The path of the filesystem item to be iterated over.

    flags

    Flags may be provided which will affect the behavior of some methods. A list of the flags can found under FilesystemIterator predefined constants. They can also be set later with FilesystemIterator::setFlags()

    Fehler/Exceptions

    Throws an UnexpectedValueException if the directory does not exist.

    Throws a ValueError if the directory is an empty string.

    Changelog

    VersionBeschreibung
    8.2.0 Prior to PHP 8.2.0, FilesystemIterator::SKIP_DOTS was always set and could not be removed.
    8.0.0 Now throws a ValueError if directory is an empty string; previously it threw a RuntimeException.

    Beispiele

    Beispiel #1 FilesystemIterator::__construct() example

    <?php
    $it     = new FilesystemIterator(dirname(__FILE__), FilesystemIterator::CURRENT_AS_FILEINFO);
    foreach (    $it as $fileinfo) {
    echo     $fileinfo->getFilename() . "\n";
    }
    ?>

    Das oben gezeigte Beispiel erzeugt mit PHP 8.2 eine ähnliche Ausgabe wie:

    . .. apples.jpg banana.jpg example.php

    Output of the above example prior to PHP 8.2.0 is similar to:

    apples.jpg banana.jpg example.php

    Siehe auch

    To Top