Create dir_scan_recursive() (#6)

Co-authored-by: onairmarc <[email protected]>

Author: onairmarc

.git-blame-ignore-revs

@@ -3,3 +3,4 @@ a709fafb67d0f1ee38b072390385ec486416aa3e
 00a48bf6a894d24c9ed4c82bee6297ed24769e34
 c0c6bf6fb1c3ad80ff54b7420853ecc9096ee576
 d637c653da4a72e3b2b1132c1f0a4af3e0135387
+de3cddf99b38b4504132eb7449c2b7a20aee5cc3

src/ObjectHelpers/dir_helpers.php

@@ -24,3 +24,11 @@ function dir_scan(string $dir): array
         return Directory::scan($dir);
     }
 }
+
+if (!function_exists('dir_scan_recursive')) {
+    /** @experimental */
+    function dir_scan_recursive(string $path): array
+    {
+        return Directory::scanRecursive($path);
+    }
+}

src/Objects/Directory.php

@@ -4,6 +4,8 @@
 
 use EncoreDigitalGroup\StdLib\Exceptions\DirectoryNotFoundException;
 use EncoreDigitalGroup\StdLib\Exceptions\ImproperBooleanReturnedException;
+use RecursiveDirectoryIterator;
+use RecursiveIteratorIterator;
 
 /**
  * @api
@@ -79,4 +81,26 @@ public static function scan(string $dir, array &$results = []): array
 
         return $results;
     }
+
+    /**
+     * List all files in a directory recursively
+     *
+     * @codeCoverageIgnore
+     */
+    public static function scanRecursive(string $path): array
+    {
+        $directoryFiles = new RecursiveIteratorIterator(
+            new RecursiveDirectoryIterator($path),
+            RecursiveIteratorIterator::SELF_FIRST
+        );
+
+        $files = [];
+        foreach ($directoryFiles as $file) {
+            if ($file->isFile()) {
+                $files[] = $file->getRealpath();
+            }
+        }
+
+        return $files;
+    }
 }