Use the Ldap factory in the ldap service definition

as LdapClient has been marked deprecated in 3.1.

Refs symfony/symfony#19008

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,12 +81,18 @@ 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>
@@ -94,12 +105,16 @@ definition:
 
         $container
             ->setDefinition('ldap', new Definition(LdapClient::class, array(
-                'my-server',
-                389,
-                3,
-                false,
-                true,
-
+                'ext_ldap',
+                array(
+                    'host'       => '127.0.0.1'
+                    'port'       => '389'
+                    'version'    => 3
+                    'encryption' => 'none'
+                    'debug'      => false,
+                    'referrals'  => false
+                    'options'    => array()
+                )
             ));
 
 Fetching Users Using the LDAP User Provider