5 * Copyright (c) 2009-2010, Sebastian Bergmann <sb@sebastian-bergmann.de>.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * * Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in
17 * the documentation and/or other materials provided with the
20 * * Neither the name of Sebastian Bergmann nor the names of his
21 * contributors may be used to endorse or promote products derived
22 * from this software without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
27 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
28 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
29 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
30 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
31 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
34 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 * POSSIBILITY OF SUCH DAMAGE.
38 * @author Sebastian Bergmann <sb@sebastian-bergmann.de>
39 * @copyright 2009-2010 Sebastian Bergmann <sb@sebastian-bergmann.de>
40 * @license http://www.opensource.org/licenses/bsd-license.php BSD License
41 * @since File available since Release 1.1.0
44 require_once 'File/Iterator.php';
47 * Factory Method implementation that creates a File_Iterator that operates on
48 * an AppendIterator that contains an RecursiveDirectoryIterator for each given
51 * @author Sebastian Bergmann <sb@sebastian-bergmann.de>
52 * @copyright 2009-2010 Sebastian Bergmann <sb@sebastian-bergmann.de>
53 * @license http://www.opensource.org/licenses/bsd-license.php BSD License
54 * @version Release: 1.2.3
55 * @link http://github.com/sebastianbergmann/php-file-iterator/tree
56 * @since Class available since Release 1.1.0
58 class File_Iterator_Factory
61 * @param array|string $paths
62 * @param array|string $suffixes
63 * @param array|string $prefixes
64 * @param array $exclude
65 * @return AppendIterator
67 public static function getFileIterator($paths, $suffixes = '', $prefixes = '', array $exclude = array())
69 if (is_string($paths)) {
70 $paths = array($paths);
75 foreach ($paths as $path) {
76 if ($locals = glob($path, GLOB_ONLYDIR)) {
77 $_paths = array_merge($_paths, $locals);
86 if (is_string($prefixes)) {
87 if ($prefixes != '') {
88 $prefixes = array($prefixes);
94 if (is_string($suffixes)) {
95 if ($suffixes != '') {
96 $suffixes = array($suffixes);
102 $iterator = new AppendIterator;
104 foreach ($paths as $path) {
108 new RecursiveIteratorIterator(
109 new RecursiveDirectoryIterator($path)
124 * @param array|string $paths
125 * @param array|string $suffixes
126 * @param array|string $prefixes
127 * @param array $exclude
130 public static function getFilesAsArray($paths, $suffixes = '', $prefixes = '', array $exclude = array())
132 if (is_string($paths)) {
133 $paths = array($paths);
138 $iterator = self::getFileIterator(
139 $paths, $suffixes, $prefixes, $exclude
142 foreach ($iterator as $file) {
143 $result[] = $file->getRealPath();
146 foreach ($paths as $path) {
147 if (is_file($path)) {
148 $result[] = realpath($path);