Allow fetching extra metadata

src/AsyncAwsS3/AsyncAwsS3Adapter.php

@@ -254,6 +254,17 @@ public function fileSize(string $path): FileAttributes
         return $attributes;
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        $attributes = $this->fetchFileMetadata($path, FileAttributes::ATTRIBUTE_EXTRA_METADATA);
+
+        if (null === $attributes->extraMetadata()) {
+            throw UnableToRetrieveMetadata::extraMetadata($path);
+        }
+
+        return $attributes;
+    }
+
     public function listContents(string $path, bool $deep): iterable
     {
         $prefix = trim($this->prefixer->prefixPath($path), '/');

src/AwsS3V3/AwsS3V3Adapter.php

@@ -349,6 +349,17 @@ public function fileSize(string $path): FileAttributes
         return $attributes;
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        $attributes = $this->fetchFileMetadata($path, FileAttributes::ATTRIBUTE_EXTRA_METADATA);
+
+        if ($attributes->extraMetadata() === null) {
+            throw UnableToRetrieveMetadata::extraMetadata($path);
+        }
+
+        return $attributes;
+    }
+
     public function listContents(string $path, bool $deep): iterable
     {
         $prefix = trim($this->prefixer->prefixPath($path), '/');

src/Filesystem.php

@@ -125,6 +125,11 @@ public function mimeType(string $path): string
         return $this->adapter->mimeType($this->pathNormalizer->normalizePath($path))->mimeType();
     }
 
+    public function extraMetadata(string $path): array
+    {
+        return $this->adapter->extraMetadata($this->pathNormalizer->normalizePath($path))->extraMetadata();
+    }
+
     public function setVisibility(string $path, string $visibility): void
     {
         $this->adapter->setVisibility($this->pathNormalizer->normalizePath($path), $visibility);

src/FilesystemAdapter.php

@@ -87,6 +87,12 @@ public function lastModified(string $path): FileAttributes;
      */
     public function fileSize(string $path): FileAttributes;
 
+    /**
+     * @throws UnableToRetrieveMetadata
+     * @throws FilesystemException
+     */
+    public function extraMetadata(string $path): FileAttributes;
+
     /**
      * @return iterable<StorageAttributes>
      *

src/FilesystemReader.php

@@ -63,4 +63,10 @@ public function mimeType(string $path): string;
      * @throws FilesystemException
      */
     public function visibility(string $path): string;
+
+    /**
+     * @throws UnableToRetrieveMetadata
+     * @throws FilesystemException
+     */
+    public function extraMetadata(string $path): array;
 }

src/Ftp/FtpAdapter.php

@@ -332,6 +332,11 @@ public function visibility(string $path): FileAttributes
         return $this->fetchMetadata($path, FileAttributes::ATTRIBUTE_VISIBILITY);
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        return $this->fetchMetadata($path, FileAttributes::ATTRIBUTE_EXTRA_METADATA);
+    }
+
     public function fileSize(string $path): FileAttributes
     {
         $location = $this->prefixer->prefixPath($path);

src/GoogleCloudStorage/GoogleCloudStorageAdapter.php

@@ -195,6 +195,11 @@ public function fileSize(string $path): FileAttributes
         return $this->fileAttributes($path, 'fileSize');
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        return $this->fileAttributes($path, 'extraMetadata');
+    }
+
     private function fileAttributes(string $path, string $type): FileAttributes
     {
         $exception = null;

src/InMemory/InMemoryFile.php

@@ -27,6 +27,11 @@ class InMemoryFile
      */
     private $visibility;
 
+    /**
+     * @var array[]
+     */
+    private $extraMetadata;
+
     public function updateContents(string $contents): void
     {
         $this->contents = $contents;
@@ -75,4 +80,14 @@ public function visibility(): ?string
     {
         return $this->visibility;
     }
+
+    public function extraMetadata(): array
+    {
+        return $this->extraMetadata;
+    }
+
+    public function setExtraMetadata(array $extraMetadata): void
+    {
+        $this->extraMetadata = $extraMetadata;
+    }
 }

src/InMemory/InMemoryFilesystemAdapter.php

@@ -168,6 +168,17 @@ public function fileSize(string $path): FileAttributes
         return new FileAttributes($path, $this->files[$path]->fileSize());
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        $path = $this->preparePath($path);
+
+        if (array_key_exists($path, $this->files) === false) {
+            throw UnableToRetrieveMetadata::extraMetadata($path, 'file does not exist');
+        }
+
+        return new FileAttributes($path, null, null, null, null, $this->files[$path]->extraMetadata());
+    }
+
     public function listContents(string $path, bool $deep): iterable
     {
         $prefix = rtrim($this->preparePath($path), '/') . '/';

src/Local/LocalFilesystemAdapter.php

@@ -377,6 +377,11 @@ public function mimeType(string $path): FileAttributes
         return new FileAttributes($path, null, null, null, $mimeType);
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        throw UnableToRetrieveMetadata::extraMetadata($path, 'No extra metadata available for local files');
+    }
+
     public function lastModified(string $path): FileAttributes
     {
         $location = $this->prefixer->prefixPath($path);

src/PhpseclibV2/SftpAdapter.php

@@ -251,6 +251,11 @@ public function visibility(string $path): FileAttributes
         return $this->fetchFileMetadata($path, FileAttributes::ATTRIBUTE_VISIBILITY);
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        return $this->fetchFileMetadata($path, FileAttributes::ATTRIBUTE_EXTRA_METADATA);
+    }
+
     public function listContents(string $path, bool $deep): iterable
     {
         $connection = $this->connectionProvider->provideConnection();

src/PhpseclibV3/SftpAdapter.php

@@ -251,6 +251,11 @@ public function visibility(string $path): FileAttributes
         return $this->fetchFileMetadata($path, FileAttributes::ATTRIBUTE_VISIBILITY);
     }
 
+    public function extraMetadata(string $path): FileAttributes
+    {
+        return $this->fetchFileMetadata($path, FileAttributes::ATTRIBUTE_EXTRA_METADATA);
+    }
+
     public function listContents(string $path, bool $deep): iterable
     {
         $connection = $this->connectionProvider->provideConnection();

src/UnableToRetrieveMetadata.php

@@ -44,6 +44,11 @@ public static function mimeType(string $location, string $reason = '', Throwable
         return static::create($location, FileAttributes::ATTRIBUTE_MIME_TYPE, $reason, $previous);
     }
 
+    public static function extraMetadata(string $location, string $reason = '', Throwable $previous = null): self
+    {
+        return static::create($location, FileAttributes::ATTRIBUTE_EXTRA_METADATA, $reason, $previous);
+    }
+
     public static function create(string $location, string $type, string $reason = '', Throwable $previous = null): self
     {
         $e = new static("Unable to retrieve the $type for file at location: $location. {$reason}", 0, $previous);