[12.x] add allDirectories() method to Filesytem (#57565)

* add `allDirectories()` method to `Filesytem`

we already have `files()`, `allFiles()`, and `directories()`, so this method completes the set and allows us to recursively get all directories within a given path.

* minor formatting

* return string path names instead of `SplFileInfo`s

Author: browner12

src/Illuminate/Filesystem/Filesystem.php

@@ -622,6 +622,22 @@ public function directories($directory)
         return $directories;
     }
 
+    /**
+     * Get all the directories within a given directory (recursive).
+     *
+     * @return array
+     */
+    public function allDirectories(string $directory): array
+    {
+        $directories = [];
+
+        foreach (Finder::create()->in($directory)->directories()->sortByName() as $dir) {
+            $directories[] = $dir->getPathname();
+        }
+
+        return $directories;
+    }
+
     /**
      * Ensure a directory exists.
      *

src/Illuminate/Support/Facades/File.php

@@ -42,6 +42,7 @@
  * @method static \Symfony\Component\Finder\SplFileInfo[] files(string $directory, bool $hidden = false)
  * @method static \Symfony\Component\Finder\SplFileInfo[] allFiles(string $directory, bool $hidden = false)
  * @method static array directories(string $directory)
+ * @method static array allDirectories(string $directory)
  * @method static void ensureDirectoryExists(string $path, int $mode = 0755, bool $recursive = true)
  * @method static bool makeDirectory(string $path, int $mode = 0755, bool $recursive = false, bool $force = false)
  * @method static bool moveDirectory(string $from, string $to, bool $overwrite = false)

tests/Filesystem/FilesystemTest.php

@@ -525,6 +525,21 @@ public function testDirectoriesFindsDirectories()
         $this->assertContains(self::$tempDir.DIRECTORY_SEPARATOR.'music', $directories);
     }
 
+    public function testAllDirectoriesFindsDirectories()
+    {
+        mkdir(self::$tempDir.'/film');
+        mkdir(self::$tempDir.'/music');
+        mkdir(self::$tempDir.'/music/rock');
+        mkdir(self::$tempDir.'/music/blues');
+
+        $directories = (new Filesystem)->allDirectories(self::$tempDir);
+
+        $this->assertContains(self::$tempDir.DIRECTORY_SEPARATOR.'film', $directories);
+        $this->assertContains(self::$tempDir.DIRECTORY_SEPARATOR.'music', $directories);
+        $this->assertContains(self::$tempDir.DIRECTORY_SEPARATOR.'music'.DIRECTORY_SEPARATOR.'rock', $directories);
+        $this->assertContains(self::$tempDir.DIRECTORY_SEPARATOR.'music'.DIRECTORY_SEPARATOR.'blues', $directories);
+    }
+
     public function testMakeDirectory()
     {
         $files = new Filesystem;