diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 4c2ef3c1254..0870a4148dd 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -782,6 +782,38 @@ the option::
This closure receives as argument the value of the option after validating it
and before normalizing it when the option is being resolved.
+Chaining option configurations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In many cases you may need to define multiple configurations for each option.
+For example, suppose the ``Mailer`` class has an ``host`` option that is required
+and a ``transport`` option which can be one of ``sendmail``, ``mail`` and ``smtp``.
+You can improve the readability of the code avoiding to duplicate option name for
+each configuration using the method
+:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::define``::
+
+ // ...
+ class Mailer
+ {
+ // ...
+ public function configureOptions(OptionsResolver $resolver)
+ {
+ // ...
+ $resolver->define('host')
+ ->required()
+ ->default('smtp.example.org')
+ ->allowedTypes('string');
+ $resolver->define('transport')
+ ->required()
+ ->default('transport')
+ ->allowedValues(['sendmail', 'mail', 'smtp']);
+ }
+ }
+
+.. versionadded:: 5.1
+
+ The ``define()`` method was introduced in Symfony 5.1.
+
Performance Tweaks
~~~~~~~~~~~~~~~~~~
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