[LDAP] Add docs for applyOperations method

mablae · web-flow · commit 933a5bd85f55 · 2018-05-01T14:17:49.000+02:00
See PR symfony/symfony#27069
diff --git a/components/ldap.rst b/components/ldap.rst
@@ -137,6 +137,35 @@ delete existing ones::
     // Removing an existing entry
     $entryManager->remove(new Entry('cn=Test User,dc=symfony,dc=com'));
 
+
+Batch Updating
+___________
+
+Use the EntryManager's ``applyOperations()`` method to update multiple attributes at once::
+
+
+    use Symfony\Component\Ldap\Ldap;
+    use Symfony\Component\Ldap\Entry;
+    // ...
+
+    $entry = new Entry('cn=Fabien Potencier,dc=symfony,dc=com', array(
+        'sn' => array('fabpot'),
+        'objectClass' => array('inetOrgPerson'),
+    ));
+
+    $entryManager = $ldap->getEntryManager();
+
+    // Adding multiple email adresses at once
+    $entryManager->applyOperations($entry->getDn(), array(
+        new UpdateOpteration(LDAP_MODIFY_BATCH_ADD, 'mail', 'new1@example.com'),
+        new UpdateOpteration(LDAP_MODIFY_BATCH_ADD, 'mail', 'new2@example.com'),
+    ));
+
+Possible operation types are ``LDAP_MODIFY_BATCH_ADD``, ``LDAP_MODIFY_BATCH_REMOVE``, ``LDAP_MODIFY_BATCH_REMOVE_ALL``, ``LDAP_MODIFY_BATCH_REPLACE``. Parameter ``$values`` must be ``NULL`` when using ``LDAP_MODIFY_BATCH_REMOVE_ALL`` operation type.
+
+.. versionadded:: 4.2
+    The ``applyOperations()`` was introduced in Symfony 4.2.
+    
 .. versionadded:: 4.1
     The ``addAttributeValues()`` and ``removeAttributeValues()`` methods
     were introduced in Symfony 4.1.
