@throws AccessException If called from a lazy option, a normalizer or a root definition

public function setPrototype(bool $prototype): static


Dans le composant OptionsResolver de Symfony, la méthode setPrototype() est utilisée pour configurer les options d'un tableau d'options, où les clés du tableau sont variables.  Cela est particulièrement utile lorsque vous ne connaissez pas à l'avance les noms exacts des options qui seront présentes dans le tableau


Exemple : Utilisation de setPrototype()

Supposons que vous ayez une option notifications qui est un tableau. Chaque élément de ce tableau représente une notification et peut avoir les options email et sms. Vous ne savez pas combien de notifications il y aura dans le tableau.

use Symfony\Component\OptionsResolver\OptionsResolver;

$resolver = new OptionsResolver();

$resolver->setPrototype(function (OptionsResolver $notificationResolver) {
    $notificationResolver->define('email')
        ->setRequired()
        ->setAllowedTypes('string')
        ->setInfo('Adresse email pour la notification.');

    $notificationResolver->define('sms')
        ->setDefault(false)
        ->setAllowedTypes('bool')
        ->setInfo('Indique si une notification SMS doit être envoyée.');
});

$resolver->define('notifications')
    ->setAllowedTypes('array')
    ->setInfo('Tableau des configurations de notification.');

// Exemple de données d'options :
$options = [
    'notifications' => [
        'user123' => [ // Clé dynamique : identifiant de l'utilisateur
            'email' => 'user123@example.com',
            'sms' => true,
        ],
        'order456' => [ // Clé dynamique : identifiant de la commande
            'email' => 'order456@example.com',
        ],
    ],
];

$resolvedOptions = $resolver->resolve($options);

print_r($resolvedOptions);


Dans cet exemple :

  • setPrototype() est utilisé pour définir un OptionsResolver qui configure chaque notification individuelle.  Chaque notification doit avoir une option email (de type string) et peut avoir une option sms (de type booléen, avec une valeur par défaut de false).

  • L'option notifications est définie comme un tableau.

  • Lorsque les options sont résolues, OptionsResolver applique la configuration du prototype à chaque élément du tableau notifications, validant ainsi que chaque notification a les options appropriées.




Powered by Froala Editor