Use the Ldap factory in the ldap service definition

as LdapClient has been marked deprecated in 3.1.

Refs symfony/symfony#19008, #6982

Author: nietonfir

security/ldap.rst

@@ -59,13 +59,18 @@ definition:
         # app/config/services.yml
         services:
             ldap:
-                class: Symfony\Component\Ldap\LdapClient
+                class: 'Symfony\Component\Ldap\Ldap'
+                factory: ['Symfony\Component\Ldap\Ldap', 'create']
                 arguments:
-                    - my-server   # host
-                    - 389         # port
-                    - 3           # version
-                    - false       # SSL
-                    - true        # TLS
+                    - 'ext_ldap'         # associated adapter - only one currently
+                    - host: '127.0.0.1'  # host
+                      port: '389'        # port
+                      version: 3         # version
+                      encryption: 'none' # either 'tls', 'ssl' or 'none'
+                      debug: false,      # Enable debugging output
+                      referrals: false   # Follow referrals returned by the server
+                      options: []        # additional PHP LDAP options
+                                         # see http://php.net/manual/en/function.ldap-set-option.php
 
     .. code-block:: xml
 
@@ -76,31 +81,45 @@ definition:
             xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="ldap" class="Symfony\Component\Ldap\LdapClient">
-                    <argument>my-server</argument>
-                    <argument>389</argument>
-                    <argument>3</argument>
-                    <argument>false</argument>
-                    <argument>true</argument>
+                <service id="ldap" class="Symfony\Component\Ldap\Ldap">
+                    <factory class="Symfony\Component\Ldap\Ldap" method="create" />
+                    <argument>ext_ldap</argument>
+                    <argument type="collection">
+                        <argument key="host">127.0.0.1</argument>
+                        <argument key="port">389</argument>
+                        <argument key="version">3</argument>
+                        <argument key="encryption">none</argument>
+                        <argument key="debug">false</argument>
+                        <argument key="referrals">false</argument>
+                        <argument key="options" type="collection"></argument>
+                    </argument>
                 </service>
             </services>
         </container>
 
     .. code-block:: php
 
-        // app/config/services.php
-        use Symfony\Component\Ldap\LdapClient;
+        use Symfony\Component\Ldap\Ldap;
         use Symfony\Component\DependencyInjection\Definition;
+        // …
+
+        // app/config/services.php
+        $definition = new Definition(Ldap::class, array(
+            'ext_ldap',
+            array(
+                'host'       => '127.0.0.1'
+                'port'       => '389'
+                'version'    => 3
+                'encryption' => 'none'
+                'debug'      => false,
+                'referrals'  => false
+                'options'    => array()
+            )
+        ));
+        $definition->setFactory(array(Ldap::class, 'create'));
 
         $container
-            ->setDefinition('ldap', new Definition(LdapClient::class, array(
-                'my-server',
-                389,
-                3,
-                false,
-                true,
-
-            ));
+            ->setDefinition('ldap', $definition);
 
 Fetching Users Using the LDAP User Provider
 -------------------------------------------