FSFileBackendList.php

Go to the documentation of this file.

<?php
abstract class FSFileBackendList implements Iterator {
    protected $iter;
 
    protected $suffixStart;
 
    protected $pos = 0;
 
    protected $params = [];
 
    public function __construct( $dir, array $params ) {
        $path = realpath( $dir ); // normalize
        if ( $path === false ) {
            $path = $dir;
        }
        $this->suffixStart = strlen( $path ) + 1; // size of "path/to/dir/"
        $this->params = $params;
 
        try {
            $this->iter = $this->initIterator( $path );
        } catch ( UnexpectedValueException $e ) {
            $this->iter = null; // bad permissions? deleted?
        }
    }
 
    protected function initIterator( $dir ) {
        if ( !empty( $this->params['topOnly'] ) ) { // non-recursive
            # Get an iterator that will get direct sub-nodes
            return new DirectoryIterator( $dir );
        } else { // recursive
            # Get an iterator that will return leaf nodes (non-directories)
            # RecursiveDirectoryIterator extends FilesystemIterator.
            # FilesystemIterator::SKIP_DOTS default is inconsistent in PHP 5.3.x.
            $flags = FilesystemIterator::CURRENT_AS_SELF | FilesystemIterator::SKIP_DOTS;
 
            return new RecursiveIteratorIterator(
                new RecursiveDirectoryIterator( $dir, $flags ),
                RecursiveIteratorIterator::CHILD_FIRST // include dirs
            );
        }
    }
 
    public function key() {
        return $this->pos;
    }
 
    public function current() {
        return $this->getRelPath( $this->iter->current()->getPathname() );
    }
 
    public function next() {
        try {
            $this->iter->next();
            $this->filterViaNext();
        } catch ( UnexpectedValueException $e ) { // bad permissions? deleted?
            throw new FileBackendError( "File iterator gave UnexpectedValueException." );
        }
        ++$this->pos;
    }
 
    public function rewind() {
        $this->pos = 0;
        try {
            $this->iter->rewind();
            $this->filterViaNext();
        } catch ( UnexpectedValueException $e ) { // bad permissions? deleted?
            throw new FileBackendError( "File iterator gave UnexpectedValueException." );
        }
    }
 
    public function valid() {
        return $this->iter && $this->iter->valid();
    }
 
    protected function filterViaNext() {
    }
 
    protected function getRelPath( $dir ) {
        $path = realpath( $dir );
        if ( $path === false ) {
            $path = $dir;
        }
 
        return strtr( substr( $path, $this->suffixStart ), '\\', '/' );
    }
}