feat(metadata): throwOnNotFound option

src/Metadata/ApiResource.php

@@ -958,6 +958,7 @@ public function __construct(
         $provider = null,
         $processor = null,
         protected ?OptionsInterface $stateOptions = null,
+        protected ?bool $throwOnNotFound = null,
         protected array $extraProperties = [],
     ) {
         parent::__construct(
@@ -998,6 +999,7 @@ class: $class,
             provider: $provider,
             processor: $processor,
             stateOptions: $stateOptions,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties
         );
 

src/Metadata/Delete.php

@@ -92,6 +92,7 @@ public function __construct(
         $provider = null,
         $processor = null,
         OptionsInterface $stateOptions = null,
+        bool $throwOnNotFound = null,
         array $extraProperties = [],
     ) {
         parent::__construct(
@@ -167,6 +168,7 @@ class: $class,
             processor: $processor,
             extraProperties: $extraProperties,
             collectDenormalizationErrors: $collectDenormalizationErrors,
+            throwOnNotFound: $throwOnNotFound,
             stateOptions: $stateOptions,
         );
     }

src/Metadata/Get.php

@@ -92,6 +92,7 @@ public function __construct(
         $provider = null,
         $processor = null,
         OptionsInterface $stateOptions = null,
+        bool $throwOnNotFound = null,
         array $extraProperties = [],
     ) {
         parent::__construct(
@@ -166,6 +167,7 @@ class: $class,
             provider: $provider,
             processor: $processor,
             stateOptions: $stateOptions,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties,
         );
     }

src/Metadata/GetCollection.php

@@ -93,6 +93,7 @@ public function __construct(
         $processor = null,
         OptionsInterface $stateOptions = null,
         array $extraProperties = [],
+        bool $throwOnNotFound = null,
         private ?string $itemUriTemplate = null,
     ) {
         parent::__construct(
@@ -166,8 +167,9 @@ class: $class,
             name: $name,
             provider: $provider,
             processor: $processor,
-            extraProperties: $extraProperties,
+            throwOnNotFound: $throwOnNotFound,
             stateOptions: $stateOptions,
+            extraProperties: $extraProperties,
         );
     }
 

src/Metadata/HttpOperation.php

@@ -197,6 +197,7 @@ public function __construct(
         $provider = null,
         $processor = null,
         OptionsInterface $stateOptions = null,
+        bool $throwOnNotFound = null,
         array $extraProperties = [],
     ) {
         parent::__construct(
@@ -244,6 +245,7 @@ class: $class,
             provider: $provider,
             processor: $processor,
             stateOptions: $stateOptions,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties
         );
     }

src/Metadata/Metadata.php

@@ -69,6 +69,7 @@
         protected $provider = null,
         protected $processor = null,
         protected ?OptionsInterface $stateOptions = null,
+        protected ?bool $throwOnNotFound = null,
         protected array $extraProperties = []
     ) {
     }
@@ -566,6 +567,19 @@
         return $self;
     }
 
+    public function getThrowOnNotFound(): ?bool
+    {
+        return $this->throwOnNotFound;
+    }
+
+    public function withThrowOnNotFound(bool $throwOnNotFound): bool
+    {
+        $self = clone $this;
+        $self->throwOnNotFound = $throwOnNotFound;
+
+        return $self;
+    }
+
     public function getExtraProperties(): ?array
     {
         return $this->extraProperties;

src/Metadata/Operation.php

@@ -799,6 +799,7 @@ public function __construct(
         protected $provider = null,
         protected $processor = null,
         protected ?OptionsInterface $stateOptions = null,
+        protected ?bool $throwOnNotFound = null,
         protected array $extraProperties = [],
     ) {
         parent::__construct(
@@ -839,6 +840,7 @@ class: $class,
             provider: $provider,
             processor: $processor,
             stateOptions: $stateOptions,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties,
         );
     }

src/Metadata/Patch.php

@@ -91,6 +91,7 @@ public function __construct(
         string $name = null,
         $provider = null,
         $processor = null,
+        bool $throwOnNotFound = null,
         OptionsInterface $stateOptions = null,
         array $extraProperties = [],
     ) {
@@ -167,6 +168,7 @@ class: $class,
             provider: $provider,
             processor: $processor,
             stateOptions: $stateOptions,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties
         );
     }

src/Metadata/Post.php

@@ -92,6 +92,7 @@ public function __construct(
         $provider = null,
         $processor = null,
         OptionsInterface $stateOptions = null,
+        bool $throwOnNotFound = null,
         array $extraProperties = [],
         private ?string $itemUriTemplate = null
     ) {
@@ -168,6 +169,7 @@ class: $class,
             provider: $provider,
             processor: $processor,
             stateOptions: $stateOptions,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties
         );
     }

src/Metadata/Put.php

@@ -92,6 +92,7 @@ public function __construct(
         $provider = null,
         $processor = null,
         OptionsInterface $stateOptions = null,
+        bool $throwOnNotFound = null,
         array $extraProperties = [],
         private ?bool $allowCreate = null,
     ) {
@@ -168,6 +169,7 @@ class: $class,
             provider: $provider,
             processor: $processor,
             stateOptions: $stateOptions,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties
         );
     }

src/State/Provider/ReadProvider.php

@@ -77,13 +77,7 @@ public function provide(Operation $operation, array $uriVariables = [], array $c
             $data = null;
         }
 
-        if (
-            null === $data
-            && 'POST' !== $operation->getMethod()
-            && ('PUT' !== $operation->getMethod()
-                || ($operation instanceof Put && !($operation->getAllowCreate() ?? false))
-            )
-        ) {
+        if (null === $data && $operation->getThrowOnNotFound()) {
             throw new NotFoundHttpException('Not Found');
         }
 

src/Symfony/Controller/MainController.php

@@ -19,6 +19,7 @@
 use ApiPlatform\Metadata\Error;
 use ApiPlatform\Metadata\Exception\RuntimeException;
 use ApiPlatform\Metadata\HttpOperation;
+use ApiPlatform\Metadata\Put;
 use ApiPlatform\Metadata\Resource\Factory\ResourceMetadataCollectionFactoryInterface;
 use ApiPlatform\State\ProcessorInterface;
 use ApiPlatform\State\ProviderInterface;
@@ -79,6 +80,15 @@ public function __invoke(Request $request): Response
             $operation = $operation->withDeserialize(\in_array($operation->getMethod(), ['POST', 'PUT', 'PATCH'], true));
         }
 
+        if (null === $operation->getThrowOnNotFound() && $operation instanceof HttpOperation) {
+            $operation->withThrowOnNotFound(
+                'POST' !== $operation->getMethod()
+                && ('PUT' !== $operation->getMethod()
+                    || ($operation instanceof Put && !($operation->getAllowCreate() ?? false))
+                )
+            );
+        }
+
         $body = $this->provider->provide($operation, $uriVariables, $context);
 
         // The provider can change the Operation, extract it again from the Request attributes