SPL: DirectoryFilterDots und die Frage nach dem Sinn

[fab]

Die SPL Iteratoren sind eine tolle Sache aber leider wenig dokumentiert, da steige ich immer noch nicht völlig durch. Kann mir mal jemand erklären, was für einen Sinn die Klasse DirectoryFilterDots hat?

SPL-StandardPHPLibrary: DirectoryFilterDots Class Reference

Es wird dort ein RecursiveDirectoryIterator erstellt und zusätzlich . und .. gefiltert. Da der RecursiveDirectoryIterator diese aber ohnehin ignoriert sehe ich beim besten Willen keinen Unterschied.

// RecursiveDirectoryIterator (hier nicht wirklich rekursiv, da ohne RecursiveIteratorIterator)
$it = new RecursiveDirectoryIterator(dirname(__FILE__));
foreach($it as $key=>$value) {
    echo sprintf("%s => %s (%s)\n", $key, $value, get_class($value));
}

// DirectoryFilterDots (erzeugt die gleiche Ausgabe)
$it = new DirectoryFilterDots(dirname(__FILE__));
foreach($it as $key=>$value) {
    echo sprintf("%s => %s (%s)\n", $key, $value, get_class($value));
} 

Habe ich also irgendeinen Vorteil dadurch?

[Dormilich]

nunja, wie der Name und die Beschreibung sagen:

Further more it filters the entries '.' and '..'.

[fab]

Und wie ich schon sagte

Da der RecursiveDirectoryIterator diese aber ohnehin ignoriert sehe ich beim besten Willen keinen Unterschied.

[mermshaus]

Da der RecursiveDirectoryIterator diese aber ohnehin ignoriert sehe ich beim besten Willen keinen Unterschied.

Bei mir werden im ersten Fall die Dot-Dateien mit ausgegeben. Darauf deutet auch zumindest ein Beispiel in der Doku hin, in dem ebenfalls noch auf isDot geprüft wird.

- PHP: RecursiveDirectoryIterator::__construct - Manual

<?php

// siehe:
// http://www.php.net/~helly/php/ext/spl/directoryfilterdots_8inc-source.html
class DirectoryFilterDots extends RecursiveFilterIterator
{
    function __construct($path)
    {
        parent::__construct(new RecursiveDirectoryIterator($path));
    }

    function accept()
    {
        return !$this->getInnerIterator()->isDot();
    }

    function key()
    {
        return $this->getInnerIterator()->getPathname();
    }
}

$test1 = '';
$test2 = '';

// RecursiveDirectoryIterator (hier nicht wirklich rekursiv, da ohne 
// RecursiveIteratorIterator)
$it = new RecursiveDirectoryIterator(dirname(__FILE__));
foreach($it as $key=>$value) {
    $test1 .= sprintf("%s => %s (%s)\n", $key, $value, get_class($value));
}

// DirectoryFilterDots (erzeugt die gleiche Ausgabe)
$it = new DirectoryFilterDots(dirname(__FILE__));
foreach($it as $key=>$value) {
    $test2 .= sprintf("%s => %s (%s)\n", $key, $value, get_class($value));
}

#echo $test1;
#echo $test2;

var_dump($test1 === $test2);

Die ~helly-Doku ist übrigens mittlerweile über drei Jahre alt, wenn die Angaben dort stimmen. Mir ist leider keine Alternative bekannt. Ich finde die Klassen auch äußerst unzureichend dokumentiert.

Robo hat dazu glaube ich ein paar Artikel.

- Einträge mit dem Tag SPL

[Dormilich]

steht das irgendwo?

jedenfalls ist der Unterschied ein anderer, RecursiveDirectoryIterator erbt von FilesystemIterator, während DirectoryFilterDots "nur" von DirectoryIterator erbt.

außerdem kann es sein, daß es DirectoryFilterDots gar nicht mehr gibt (mein System kannte den gar nicht)

[fab]

Bei mir werden im ersten Fall die Dot-Dateien mit ausgegeben. Darauf deutet auch zumindest ein Beispiel in der Doku hin, in dem ebenfalls noch auf isDot geprüft wird.

Komisch, bei mir ist es nicht so, gut zu wissen dass man sich nicht auf diese Einstellung verlassen sollte.

Robo hat dazu glaube ich ein paar Artikel.

- Einträge mit dem Tag SPL

Danke, ich werde mal stöbern!

jedenfalls ist der Unterschied ein anderer, RecursiveDirectoryIterator erbt von FilesystemIterator, während DirectoryFilterDots "nur" von DirectoryIterator erbt.

Stimmt (außer dass es nicht DirectoryIterator ist sondern RecursiveFilterIterator), allerdings auch nur ein Grund mehr, RecursiveDirectoryIterator zu benutzen.

außerdem kann es sein, daß es DirectoryFilterDots gar nicht mehr gibt (mein System kannte den gar nicht)

Ich habe ihn heute erst entdeckt und musste ihn auf PHP 5.2.12 ebenfalls selber deklarieren. Allerdings hatte ich nichts dazu in den Changelogs gefunden, also wurde er vielleicht still und heimlich wegen Bedeutungslosigkeit entfernt?