Try adding requirements

Author: VincentLanglet

src/Doctrine/Orm/Metadata/Resource/DoctrineOrmResourceCollectionMetadataFactory.php

@@ -18,11 +18,14 @@
 use ApiPlatform\Doctrine\Orm\State\Options;
 use ApiPlatform\Metadata\CollectionOperationInterface;
 use ApiPlatform\Metadata\DeleteOperationInterface;
+use ApiPlatform\Metadata\HttpOperation;
+use ApiPlatform\Metadata\Link;
 use ApiPlatform\Metadata\Operation;
 use ApiPlatform\Metadata\Resource\Factory\ResourceMetadataCollectionFactoryInterface;
 use ApiPlatform\Metadata\Resource\ResourceMetadataCollection;
 use ApiPlatform\State\Util\StateOptionsTrait;
 use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\ORM\Mapping\ClassMetadata;
 use Doctrine\Persistence\ManagerRegistry;
 
 final class DoctrineOrmResourceCollectionMetadataFactory implements ResourceMetadataCollectionFactoryInterface
@@ -95,9 +98,56 @@ private function addDefaults(Operation $operation): Operation
             $operation = $operation->withProcessor($this->getProcessor($operation));
         }
 
+        if ($operation instanceof HttpOperation) {
+            $operation = $operation->withRequirements($this->getRequirements($operation));
+        }
+
         return $operation;
     }
 
+    /**
+     * @return array<string, string>
+     */
+    private function getRequirements(HttpOperation $operation): array
+    {
+        $requirements = $operation->getRequirements() ?? [];
+        $uriVariables = (array) ($operation->getUriVariables() ?? []);
+
+        foreach ($uriVariables as $paramName => $uriVariable) {
+            if (isset($requirements[$paramName])) {
+                continue;
+            }
+
+            if (!$uriVariable instanceof Link) {
+                continue;
+            }
+            $identifiers = $uriVariable->getIdentifiers();
+            if (count($identifiers) !== 1) {
+                continue;
+            }
+
+            $fromClass = $uriVariable->getFromClass();
+            $fieldName = $identifiers[0];
+            $classMetadata = $this->managerRegistry->getManagerForClass($fromClass)?->getClassMetadata($fromClass);
+
+            $requirement = null;
+            if ($classMetadata instanceof ClassMetadata && $classMetadata->hasField($fieldName)) {
+                $requirement = match ($classMetadata->getFieldMapping($fieldName)->type) {
+                    'uuid', 'guid' => '^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$',
+                    'ulid' => '^[0-7][0-9A-HJKMNP-TV-Z]{25}$',
+                    'smallint', 'integer', 'bigint' => '^-?[0-9]+$',
+                    default => null,
+                };
+            }
+
+            if (null !== $requirement) {
+                $requirements[$paramName] = $requirement;
+            }
+        }
+
+        return $requirements;
+    }
+
     private function getProvider(Operation $operation): string
     {
         if ($operation instanceof CollectionOperationInterface) {

src/Metadata/Link.php

@@ -19,6 +19,10 @@
 #[\Attribute(\Attribute::TARGET_PROPERTY | \Attribute::TARGET_METHOD | \Attribute::TARGET_PARAMETER)]
 final class Link extends Parameter
 {
+    /**
+     * @param class-string|null $fromClass
+     * @param class-string|null $toClass
+     */
     public function __construct(
         private ?string $parameterName = null,
         private ?string $fromProperty = null,
@@ -87,11 +91,17 @@ public function withParameterName(string $parameterName): self
         return $self;
     }
 
+    /**
+     * @return class-string|null
+     */
     public function getFromClass(): ?string
     {
         return $this->fromClass;
     }
 
+    /**
+     * @param class-string $fromClass
+     */
     public function withFromClass(string $fromClass): self
     {
         $self = clone $this;
@@ -100,11 +110,17 @@ public function withFromClass(string $fromClass): self
         return $self;
     }
 
+    /**
+     * @return class-string|null
+     */
     public function getToClass(): ?string
     {
         return $this->toClass;
     }
 
+    /**
+     * @param class-string $toClass
+     */
     public function withToClass(string $toClass): self
     {
         $self = clone $this;