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

jean-gui · jean-gui · commit 40df04189faf · 2018-04-10T11:23:53.000+02:00
Related to symfony/symfony#21856
diff --git a/components/ldap.rst b/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
