Merge pull request #1330 from phpDocumentor/feature/file-system-modified

Add lastModified to filesystem

Author: jaapio

packages/filesystem/src/FileSystem.php

@@ -56,4 +56,7 @@ public function listContents(string $directory = '', bool $recursive = false): a
     public function find(SpecificationInterface $specification): iterable;
 
     public function isDirectory(string $path): bool;
+
+    /** return the unix timestamp file was modified. */
+    public function lastModified(string $path): int;
 }

packages/filesystem/src/FlySystemAdapter.php

@@ -97,4 +97,9 @@ public function isDirectory(string $path): bool
     {
         return $this->filesystem->isDirectory($path);
     }
+
+    public function lastModified(string $path): int
+    {
+        return $this->filesystem->lastModified($path);
+    }
 }

packages/filesystem/src/FlysystemV1/FlysystemV1.php

@@ -16,6 +16,7 @@
 use Flyfinder\Finder;
 use Flyfinder\Specification\SpecificationInterface;
 use League\Flysystem\FilesystemInterface;
+use phpDocumentor\FileSystem\FileNotFoundException;
 use phpDocumentor\FileSystem\FileSystem;
 use phpDocumentor\FileSystem\StorageAttributes;
 
@@ -85,4 +86,14 @@ public function isDirectory(string $path): bool
 
         return $metadata['type'] === 'dir';
     }
+
+    public function lastModified(string $path): int
+    {
+        $timestamp = $this->filesystem->getTimestamp($path);
+        if ($timestamp === false) {
+            throw new FileNotFoundException('File not found: ' . $path);
+        }
+
+        return $timestamp;
+    }
 }

packages/filesystem/src/FlysystemV3/FlysystemV3.php

@@ -79,4 +79,9 @@ public function find(SpecificationInterface $specification): iterable
             yield new FileAttributes($file);
         }
     }
+
+    public function lastModified(string $path): int
+    {
+        return $this->filesystem->lastModified($path);
+    }
 }