[9.x] Add read-only filesystem adapter decoration as a config option (#44079)

* [NEW] Add read-only filesystem adapter decoration as a config option.

* CS fixes

* Remove function imports.

* Added suggests item for flysystem's read-only package.

Author: frankdejonge

composer.json

@@ -87,6 +87,7 @@
         "guzzlehttp/guzzle": "^7.2",
         "league/flysystem-aws-s3-v3": "^3.0",
         "league/flysystem-ftp": "^3.0",
+        "league/flysystem-read-only": "^3.3",
         "league/flysystem-sftp-v3": "^3.0",
         "mockery/mockery": "^1.4.4",
         "orchestra/testbench-core": "^7.1",
@@ -150,6 +151,7 @@
         "laravel/tinker": "Required to use the tinker console command (^2.0).",
         "league/flysystem-aws-s3-v3": "Required to use the Flysystem S3 driver (^3.0).",
         "league/flysystem-ftp": "Required to use the Flysystem FTP driver (^3.0).",
+        "league/flysystem-read-only": "Required to use read-only disks (^3.3)",
         "league/flysystem-sftp-v3": "Required to use the Flysystem SFTP driver (^3.0).",
         "mockery/mockery": "Required to use mocking (^1.4.4).",
         "nyholm/psr7": "Required to use PSR-7 bridging features (^1.2).",

src/Illuminate/Filesystem/FilesystemManager.php

@@ -16,6 +16,7 @@
 use League\Flysystem\Local\LocalFilesystemAdapter as LocalAdapter;
 use League\Flysystem\PhpseclibV3\SftpAdapter;
 use League\Flysystem\PhpseclibV3\SftpConnectionProvider;
+use League\Flysystem\ReadOnly\ReadOnlyFilesystemAdapter;
 use League\Flysystem\UnixVisibility\PortableVisibilityConverter;
 use League\Flysystem\Visibility;
 
@@ -275,6 +276,10 @@ protected function formatS3Config(array $config)
      */
     protected function createFlysystem(FlysystemAdapter $adapter, array $config)
     {
+        if ($config['read-only'] ?? false === true) {
+            $adapter = new ReadOnlyFilesystemAdapter($adapter);
+        }
+
         return new Flysystem($adapter, Arr::only($config, [
             'directory_visibility',
             'disable_asserts',

tests/Filesystem/FilesystemManagerTest.php

@@ -37,4 +37,37 @@ public function testCanBuildOnDemandDisk()
 
         rmdir(__DIR__.'/../../my-custom-path');
     }
+
+    public function testCanBuildReadOnlyDisks()
+    {
+        $filesystem = new FilesystemManager(new Application);
+
+        $disk = $filesystem->build([
+            'driver' => 'local',
+            'read-only' => true,
+            'root' => 'my-custom-path',
+            'url' => 'my-custom-url',
+            'visibility' => 'public',
+        ]);
+
+        file_put_contents(__DIR__.'/../../my-custom-path/path.txt', 'contents');
+
+        // read operations work
+        $this->assertEquals('contents', $disk->get('path.txt'));
+        $this->assertEquals(['path.txt'], $disk->files());
+
+        // write operations fail
+        $this->assertFalse($disk->put('path.txt', 'contents'));
+        $this->assertFalse($disk->delete('path.txt'));
+        $this->assertFalse($disk->deleteDirectory('directory'));
+        $this->assertFalse($disk->prepend('path.txt', 'data'));
+        $this->assertFalse($disk->append('path.txt', 'data'));
+        $handle = fopen('php://memory', 'rw');
+        fwrite($handle, 'content');
+        $this->assertFalse($disk->writeStream('path.txt', $handle));
+        fclose($handle);
+
+        unlink(__DIR__.'/../../my-custom-path/path.txt');
+        rmdir(__DIR__.'/../../my-custom-path');
+    }
 }