Deleted lib/internal/Magento/Framework/Filesystem/ExtendedDriverInterface.php. getMetadata() method moved to DataInterface

Author: vlmed

app/code/Magento/RemoteStorage/Driver/RemoteDriverInterface.php

@@ -7,12 +7,12 @@
 
 namespace Magento\RemoteStorage\Driver;
 
-use Magento\Framework\Filesystem\ExtendedDriverInterface;
+use Magento\Framework\Filesystem\DriverInterface;
 
 /**
  * Remote storage driver.
  */
-interface RemoteDriverInterface extends ExtendedDriverInterface
+interface RemoteDriverInterface extends DriverInterface
 {
     /**
      * Test storage connection.

lib/internal/Magento/Framework/Filesystem/Driver/File.php

@@ -8,6 +8,7 @@
 namespace Magento\Framework\Filesystem\Driver;
 
 use Magento\Framework\Exception\FileSystemException;
+use Magento\Framework\Filesystem\Driver\File\Mime;
 use Magento\Framework\Filesystem\DriverInterface;
 use Magento\Framework\Filesystem\Glob;
 use Magento\Framework\Phrase;
@@ -1096,4 +1097,68 @@ public function getRealPathSafety($path)
 
         return rtrim(implode(DIRECTORY_SEPARATOR, $realPath), DIRECTORY_SEPARATOR);
     }
+
+    /**
+     * Retrieve file metadata.
+     *
+     * @param string $path
+     *
+     * @return array
+     * @throws FileSystemException
+     */
+    public function getMetadata(string $path): array
+    {
+        if (!$this->isExists($path) || !$this->isFile($path)) {
+            throw new FileSystemException(__("File '$path' doesn't exist"));
+        }
+
+        $file = new \SplFileInfo($path);
+
+        $mimeType = $this->getFileMimeType($path);
+
+        if ($this->isFileAnImage($mimeType)) {
+            $imageInfo = getimagesize($path);
+            $mimeType = $imageInfo['mime'] ?? $mimeType;
+        }
+
+        return [
+            'path' => $file->getPath(),
+            'dirname' => dirname($file->getPath()),
+            'basename' => $file->getBasename(),
+            'extension' => $file->getExtension(),
+            'filename' => $file->getFilename(),
+            'timestamp' => $file->getMTime(),
+            'size' => $file->getSize(),
+            'mimetype' => $mimeType,
+            'extra' => [
+                'image-width' => $imageInfo[0] ?? 0,
+                'image-height' => $imageInfo[1] ?? 0
+            ]
+        ];
+    }
+
+    /**
+     * Checks whether file is an image
+     *
+     * @param string $mimeType
+     *
+     * @return bool
+     */
+    private function isFileAnImage(string $mimeType): bool
+    {
+        return strstr($mimeType, 'image/');
+    }
+
+    /**
+     * Returns file mime type
+     *
+     * @param string $path
+     *
+     * @return string
+     * @throws FileSystemException
+     */
+    private function getFileMimeType(string $path): string
+    {
+        return Mime::getMimeInstance()->getMimeType($path);
+    }
 }

lib/internal/Magento/Framework/Filesystem/Driver/File/Mime.php

@@ -93,6 +93,11 @@ class Mime
         'inode/x-empty',
     ];
 
+    /**
+     * @var Mime
+     */
+    private static $instance = null;
+
     /**
      * Get mime type of a file
      *
@@ -125,6 +130,20 @@ public function getMimeType(string $path): string
         return $result;
     }
 
+    /**
+     * Get Mime instance
+     *
+     * @return static
+     */
+    public static function getMimeInstance(): Mime
+    {
+        if (null === static::$instance) {
+            static::$instance = new static();
+        }
+
+        return static::$instance;
+    }
+
     /**
      * Get mime type by the native mime_content_type function.
      *

lib/internal/Magento/Framework/Filesystem/Driver/StatefulFile.php

@@ -565,4 +565,17 @@ public function getRealPathSafety($path)
     {
         return $this->driverFile->getRealPathSafety($path);
     }
+
+    /**
+     * Retrieve file metadata
+     *
+     * @param string $path
+     *
+     * @return array
+     * @throws FileSystemException
+     */
+    public function getMetadata(string $path): array
+    {
+        return $this->driverFile->getMetadata($path);
+    }
 }

lib/internal/Magento/Framework/Filesystem/DriverInterface.php

@@ -393,4 +393,31 @@ public function getRealPathSafety($path);
      * @return mixed
      */
     public function getRelativePath($basePath, $path = null);
+
+    /**
+     * Retrieve file metadata.
+     *
+     * Implementation must return associative array with next keys:
+     *
+     * ```
+     * [
+     *  'path',
+     *  'dirname',
+     *  'basename',
+     *  'extension',
+     *  'filename',
+     *  'timestamp',
+     *  'size',
+     *  'mimetype',
+     *  'extra' => [
+     *      'image-width',
+     *      'image-height'
+     *      ]
+     *  ];
+     *
+     * @param string $path Absolute path to file
+     * @return array
+     * @throws FileSystemException
+     */
+    public function getMetadata(string $path): array;
 }

lib/internal/Magento/Framework/Filesystem/ExtendedDriverInterface.php

@@ -51,6 +51,15 @@ public function testGetMimeType(string $file, string $expectedType): void
         self::assertSame($expectedType, $actualType);
     }
 
+    /**
+     * Test for getMimeInstance
+     */
+    public function testGetMimeInstance(): void
+    {
+        $mime = Mime::getMimeInstance();
+        $this->assertInstanceOf(Mime::class, $mime);
+    }
+
     /**
      * @return array
      */