[DoctrineBridge][TwigBridge] Add PHPDoc to attributes

squrious · OskarStark · commit a0e2da909e98 · 2023-12-29T23:13:10.000+01:00
diff --git a/src/Symfony/Bridge/Doctrine/Attribute/MapEntity.php b/src/Symfony/Bridge/Doctrine/Attribute/MapEntity.php
@@ -21,13 +21,61 @@
 class MapEntity extends ValueResolver
 {
     public function __construct(
+        /**
+         * The entity class.
+         *
+         * @var class-string|null
+         */
         public ?string $class = null,
+
+        /**
+         * Specify the object manager used to retrieve the entity.
+         */
         public ?string $objectManager = null,
+
+        /**
+         * An expression to fetch the entity using the ExpressionLanguage syntax.
+         *
+         * The following variables are available:
+         * - `repository` will be your entity repository.
+         * - Any request attributes are available as variables.
+         *
+         * @see https://symfony.com/doc/current/components/expression_language.html
+         */
         public ?string $expr = null,
+
+        /**
+         * Configures the properties and values to use with the findOneBy() method.
+         * The key is the route placeholder name and the value is the Doctrine property name.
+         *
+         * @var array<string, string>|null
+         */
         public ?array $mapping = null,
+
+        /**
+         * Configures the properties that should be used in the findOneBy() method by excluding
+         * one or more properties so that not all are used.
+         *
+         * @var string[]|null
+         */
         public ?array $exclude = null,
+
+        /**
+         * Whether to prevent null values from being used as parameters in the query.
+         */
         public ?bool $stripNull = null,
+
+        /**
+         * If an id option is configured and matches a route parameter, then the resolver will
+         * find by the primary key.
+         *
+         * @var string[]|string|null
+         */
         public array|string|null $id = null,
+
+        /**
+         * If true, forces Doctrine to always fetch the entity from the database instead of cache.
+         */
         public ?bool $evictCache = null,
         bool $disabled = false,
         string $resolver = EntityValueResolver::class,
diff --git a/src/Symfony/Bridge/Doctrine/Validator/Constraints/UniqueEntity.php b/src/Symfony/Bridge/Doctrine/Validator/Constraints/UniqueEntity.php
@@ -37,8 +37,13 @@ class UniqueEntity extends Constraint
     public bool|array|string $ignoreNull = true;
 
     /**
-     * @param array|string      $fields     The combination of fields that must contain unique values or a set of options
-     * @param bool|array|string $ignoreNull The combination of fields that ignore null values
+     * @param array|string         $fields           The combination of fields that must contain unique values or a set of options
+     * @param bool|string[]|string $ignoreNull       The combination of fields that ignore null values
+     * @param string|null          $em               The entity manager used to query for uniqueness instead of the manager of this class
+     * @param string|null          $entityClass      The entity class to enforce uniqueness on instead of the current class
+     * @param string|null          $repositoryMethod The repository method to check uniqueness instead of findBy. The method will receive as its argument
+     *                                               a fieldName => value associative array according to the fields option configuration
+     * @param string|null          $errorPath        Bind the constraint violation to this field instead of the first one in the fields option configuration
      */
     public function __construct(
         array|string $fields,
diff --git a/src/Symfony/Bridge/Twig/Attribute/Template.php b/src/Symfony/Bridge/Twig/Attribute/Template.php
@@ -11,6 +11,9 @@
 
 namespace Symfony\Bridge\Twig\Attribute;
 
+/**
+ * Define the template to render in the controller.
+ */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_FUNCTION)]
 class Template
 {
@@ -22,6 +25,8 @@ public function __construct(
 
         /**
          * The controller method arguments to pass to the template.
+         *
+         * @var string[]|null
          */
         public ?array $vars = null,
 
