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

Related to symfony/symfony#21856

Author: jean-gui

components/ldap.rst

@@ -129,8 +129,15 @@ delete existing ones::
     $entry = $result[0];
     $entry->setAttribute('email', array('[email protected]'));
     $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