minor #9553 Documented how to add or remove values of multi-valued attributes (jean-gui)

This PR was merged into the master branch.

Discussion
----------

Documented how to add or remove values of multi-valued attributes

Related to symfony/symfony#21856

<!--

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).

-->

Commits
-------

40df041 Documented how to add or remove values of multi-valued attributes

Author: javiereguiluz

components/ldap.rst

@@ -129,8 +129,16 @@ delete existing ones::
     $entry = $result[0];
     $entry->setAttribute('email', array('fabpot@symfony.com'));
     $entityManager->update($entry);
+    
+    // Adding or removing values to a multi-valued attribute is more efficient than using update()
+    $entityManager->addAttributeValues($entry, 'telephoneNumber', array('+1.111.222.3333', '+1.222.333.4444'));
+    $entityManager->removeAttributeValues($entry, 'telephoneNumber', array('+1.111.222.3333', '+1.222.333.4444'));
 
     // Removing an existing entry
     $entityManager->remove(new Entry('cn=Test User,dc=symfony,dc=com'));
 
+.. versionadded:: 4.1
+    The ``addAttributeValues()`` and ``removeAttributeValues()`` methods
+    were introduced in Symfony 4.1.
+
 .. _Packagist: https://packagist.org/packages/symfony/ldap