Add Stringable on storage attributes

thephpleague · Jan 7, 2025 · 1ab5499 · 1ab5499
1 parent 704c10b
commit 1ab5499
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 2 deletions.
diff --git a/src/DirectoryAttributes.php b/src/DirectoryAttributes.php
@@ -4,7 +4,7 @@
 
 namespace League\Flysystem;
 
-class DirectoryAttributes implements StorageAttributes
+class DirectoryAttributes implements StorageAttributes, \Stringable
 {
     use ProxyArrayAccessToProperties;
     private string $type = StorageAttributes::TYPE_DIRECTORY;
@@ -84,4 +84,9 @@ public function jsonSerialize(): array
             StorageAttributes::ATTRIBUTE_EXTRA_METADATA => $this->extraMetadata,
         ];
     }
+
+    public function __toString(): string
+    {
+        return sprintf('%s(%s)', $this->type, $this->path);
+    }
 }
diff --git a/src/FileAttributes.php b/src/FileAttributes.php
@@ -4,7 +4,7 @@
 
 namespace League\Flysystem;
 
-class FileAttributes implements StorageAttributes
+class FileAttributes implements StorageAttributes, \Stringable
 {
     use ProxyArrayAccessToProperties;
     private string $type = StorageAttributes::TYPE_FILE;
@@ -97,4 +97,9 @@ public function jsonSerialize(): array
             StorageAttributes::ATTRIBUTE_EXTRA_METADATA => $this->extraMetadata,
         ];
     }
+
+    public function __toString(): string
+    {
+        return sprintf('%s(%s)', $this->type, $this->path);
+    }
 }
diff --git a/src/StorageAttributes.php b/src/StorageAttributes.php
@@ -7,6 +7,9 @@
 use ArrayAccess;
 use JsonSerializable;
 
+/**
+ * @method string __toString() Stringable interface will be added in 4.0
+ */
 interface StorageAttributes extends JsonSerializable, ArrayAccess
 {
     public const ATTRIBUTE_PATH = 'path';