Fix regression on missing resource put

Some external libraries did rely on the usage of putResource. This method wasn't part of the new filesystem interface and was therefore breaking those implementations.
phpDocumentor · Mar 10, 2025 · fc5f4db · fc5f4db
1 parent b6bec6f
commit fc5f4db
Show file tree

Hide file tree

Showing 4 changed files with 21 additions and 0 deletions.
diff --git a/packages/filesystem/src/FileSystem.php b/packages/filesystem/src/FileSystem.php
@@ -46,6 +46,9 @@ public function read(string $path): string|false;
 
     public function put(string $path, string $contents): bool;
 
+    /** @param resource $resource */
+    public function putStream(string $path, $resource): void;
+
     /** @return StorageAttributes[] */
     public function listContents(string $directory = '', bool $recursive = false): array;
 

diff --git a/packages/filesystem/src/FlySystemAdapter.php b/packages/filesystem/src/FlySystemAdapter.php
@@ -75,6 +75,12 @@ public function put(string $path, string $contents): bool
         return $this->filesystem->put($path, $contents);
     }
 
+    /** @param resource $resource */
+    public function putStream(string $path, $resource): void
+    {
+        $this->filesystem->putStream($path, $resource);
+    }
+
     /** @return StorageAttributes[] */
     public function listContents(string $directory = '', bool $recursive = false): array
     {

diff --git a/packages/filesystem/src/FlysystemV1/FlysystemV1.php b/packages/filesystem/src/FlysystemV1/FlysystemV1.php
@@ -52,6 +52,12 @@ public function put(string $path, string $contents): bool
         return $this->filesystem->put($path, $contents);
     }
 
+    /** @param resource $resource */
+    public function putStream(string $path, $resource): void
+    {
+        $this->filesystem->putStream($path, $resource);
+    }
+
     /** @return StorageAttributes[] */
     public function listContents(string $directory = '', bool $recursive = false): array
     {

diff --git a/packages/filesystem/src/FlysystemV3/FlysystemV3.php b/packages/filesystem/src/FlysystemV3/FlysystemV3.php
@@ -52,6 +52,12 @@ public function put(string $path, string $contents): bool
         return true;
     }
 
+    /** @param resource $resource */
+    public function putStream(string $path, $resource): void
+    {
+        $this->filesystem->writeStream($path, $resource);
+    }
+
     /** @return FileAttributes[] */
     public function listContents(string $directory = '', bool $recursive = false): array
     {