removed exists()

src/Assets/Asset.php

@@ -20,9 +20,4 @@ public function getUrl(): string;
 	 * Shortcut for getUrl()
 	 */
 	public function __toString(): string;
-
-	/**
-	 * Checks if the asset file exists in the filesystem.
-	 */
-	public function exists(): bool;
 }

src/Assets/FileAsset.php

@@ -51,15 +51,6 @@ public function __toString(): string
 	}
 
 
-	/**
-	 * Checks if the asset file exists in the filesystem.
-	 */
-	public function exists(): bool
-	{
-		return is_file($this->path);
-	}
-
-
 	/**
 	 * Returns duration in seconds for MP3 audio file.
 	 */
@@ -89,11 +80,11 @@ public function getHeight(): int
 
 	/**
 	 * Returns the dimensions [width, height] of an image file.
-	 * @throws \RuntimeException if file is not an image or doesn't exist
+	 * @throws \RuntimeException if file is not an image
 	 */
 	private function getSize(): array
 	{
-		return $this->size ??= @getimagesize($this->getPath()) // @ - file may not exist or is not an image
+		return $this->size ??= @getimagesize($this->getPath()) // @ - file may not be an image
 			?: throw new \RuntimeException(sprintf(
 				"Cannot get size of image '%s'. %s",
 				$this->getPath(),

src/Assets/FilesystemMapper.php

@@ -27,14 +27,17 @@ public function __construct(string $baseUrl, string $basePath, array $extensions
 	/**
 	 * Returns asset instance for given reference.
 	 */
-	public function getAsset(string $reference, array $options = []): FileAsset
+	public function getAsset(string $reference, array $options = []): ?FileAsset
 	{
 		Helpers::checkOptions($options);
 		$path = $this->resolvePath($reference);
-		$ext = $this->extensions && !is_file($path)
+		$path .= $ext = $this->extensions && !is_file($path)
 			? $this->findExtension($path)
 			: '';
-		return new FileAsset($this->buildUrl($reference . $ext, $options), $path . $ext);
+
+		return is_file($path)
+			? new FileAsset($this->buildUrl($reference . $ext, $options), $path)
+			: null;
 	}
 
 

src/Assets/Mapper.php

@@ -14,5 +14,5 @@ interface Mapper
 	/**
 	 * Returns asset instance for given reference.
 	 */
-	public function getAsset(string $reference, array $options = []): Asset;
+	public function getAsset(string $reference, array $options = []): ?Asset;
 }

src/Assets/Registry.php

@@ -48,10 +48,10 @@ public function getMapper(string $id = ''): Mapper
 	/**
 	 * Returns asset instance for given mapper-qualified reference.
 	 */
-	public function getAsset(string $qualifiedRef, array $options = []): Asset
+	public function getAsset(string $qualifiedRef, array $options = []): ?Asset
 	{
 		$cacheKey = $qualifiedRef . ($options ? '?' . http_build_query($options) : '');
-		if (isset($this->cache[$cacheKey])) {
+		if (array_key_exists($cacheKey, $this->cache)) {
 			return $this->cache[$cacheKey];
 		}
 

tests/Assets/Provider.basic.phpt

@@ -30,6 +30,7 @@ class MockAsset implements Asset
 	}
 }
 
+
 class MockMapper implements Mapper
 {
 	public function __construct(