minor #11814 feature: add docs for extra fields (Simperfit)

This PR was submitted for the master branch but it was merged into the 4.4 branch instead (closes #11814).

Discussion
----------

feature: add docs for extra fields

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/roadmap for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `master` for features of unreleased versions).

-->

Fix #11810

Commits
-------

76dadf8 feature: add docs for extra fields

Author: javiereguiluz

security/ldap.rst

@@ -149,6 +149,7 @@ use the ``ldap`` user provider.
                         search_password: password
                         default_roles: ROLE_USER
                         uid_key: uid
+                        extra_fields: ['email']
 
     .. code-block:: xml
 
@@ -189,6 +190,7 @@ use the ``ldap`` user provider.
                         'search_password' => 'password',
                         'default_roles' => 'ROLE_USER',
                         'uid_key' => 'uid',
+                        'extra_fields' => ['email'],
                     ],
                 ],
             ],
@@ -268,6 +270,15 @@ implementation. Commonly used values are:
 If you pass ``null`` as the value of this option, the default UID key is used
 ``sAMAccountName``.
 
+extra_fields
+............
+
+**type**: ``array`` **default**: ``null``
+
+This is the custom fields to pull from the LDAP server. If the fields does not
+exists it will throw an \InvalidArgumentException.
+
+
 filter
 ......