diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 87bdade534a..1dc7f8cdb27 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -274,6 +274,59 @@ each with a single field.
.. include:: /reference/constraints/_groups-option.rst.inc
+``identifierFieldNames``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``null``
+
+When updating an entity through a PHP class (e.g. DTOs), this option can be used to
+define the class properties that are used as the Doctrine entity key (or composite key).
+
+Consider this Doctrine entity ::
+
+ // src/Entity/User.php
+ namespace App\Entity;
+
+ use Doctrine\ORM\Mapping as ORM;
+
+ #[ORM\Entity]
+ class User
+ {
+ #[ORM\Id]
+ #[ORM\GeneratedValue]
+ #[ORM\Column]
+ private int $id;
+
+ #[ORM\Column]
+ private string $name;
+ }
+
+ // ... getter and setter methods
+
+For exemple, in a :doc:`Messenger component ` message that
+updates ``User`` entities, you can check its uniqueness by defining its identifier::
+
+ // src/Message/UpdateEmployeeProfile
+ namespace App\Message;
+
+ use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+
+ #[UniqueEntity(
+ fields: ['name'],
+ entityClass: User::class,
+ // 'uid' is the property name in the PHP class and 'id' is the name of
+ // the Doctrine entity property used as the primary key
+ identifierFieldNames: ['uid' => 'id'],
+ )]
+ class UpdateEmployeeProfile
+ {
+ public function __construct(
+ private string $uid,
+ private string $name,
+ ) {
+ }
+ }
+
``ignoreNull``
~~~~~~~~~~~~~~
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy