feat: add Stream::autoClose()

Author: kbond

README.md

@@ -34,6 +34,9 @@ $stream = Stream::inOutput();
 
 // \tmpfile()
 $stream = Stream::tempFile();
+
+// autoclose on $stream __destruct
+$stream->autoClose(); // Stream
 ```
 
 ### Use Stream Object

src/Stream.php

@@ -18,6 +18,7 @@ final class Stream implements \Stringable
 {
     /** @var resource */
     private $resource;
+    private bool $autoClose = false;
 
     /**
      * @param resource $resource
@@ -31,6 +32,13 @@ private function __construct($resource)
         $this->resource = $resource;
     }
 
+    public function __destruct()
+    {
+        if ($this->autoClose) {
+            $this->close();
+        }
+    }
+
     public function __toString(): string
     {
         return $this->contents();
@@ -85,6 +93,13 @@ public static function open(string $filename, string $mode, bool $useIncludePath
         return new self($handle);
     }
 
+    public function autoClose(): self
+    {
+        $this->autoClose = true;
+
+        return $this;
+    }
+
     /**
      * @return resource
      */

tests/StreamTest.php

@@ -217,4 +217,19 @@ public function put_contents(): void
 
         $this->assertSame('content', \file_get_contents($file));
     }
+
+    /**
+     * @test
+     */
+    public function can_auto_close(): void
+    {
+        $stream = Stream::inMemory()->autoClose();
+        $resource = $stream->get();
+
+        $this->assertIsNotClosedResource($resource);
+
+        unset($stream);
+
+        $this->assertIsClosedResource($resource);
+    }
 }