ldap_connect

(PHP 3, PHP 4 , PHP 5)

ldap_connect -- Se connecte à un serveur LDAP

Description

resource ldap_connect ( [string hostname [, int port]] )

ldap_connect() retourne un identifiant positif de serveur LDAP en cas de succès, ou bien FALSE en cas d'erreur. Lorsque OpenLDAP 2.x.x est utilisé, ldap_connect() retournera toujours une ressource car il ne se connectera pas mais initialisera uniquement les paramètres de connexion. Actuellement, la connexion intervient avec le prochain appel aux fonctions ldap_*, habituellement avec la fonction ldap_bind().

ldap_connect() établit une connexion avec un serveur LDAP situé sur l'hôte hostname et port. Les deux arguments sont optionnels. Sans argument, l'identifiant de la dernière connexion ouverte sera retourné. Si seul hostname est spécifié, le port par défaut est 389.

Si vous utilisez OpenLDAP 2.x.x, vous pouvez spécifier une URL au lieu d'un nom d'hôte. Pour utiliser LDAP avec SSL, compilez OpenLDAP 2.x.x avec le support SSL, configurez PHP avec SSL, et utilisez ldaps://hostname/ comme nom d'hôte. Le paramètre de port port n'est pas utile lorsqu'utilisé avec des URL.

Note : Le support des URL et SSL a été ajouté en PHP 4.0.4.

Exemple 1. Exemple de connexion à un serveur LDAP

<?php

// LDAP variables
$ldaphost = "ldap.example.com";  // votre serveur LDAP
$ldapport = 389;                 // votre port de serveur LDAP

// Connecting to LDAP
$ldapconn = ldap_connect( $ldaphost, $ldapport )
          or die(
"Impossible de se connecter au serveur LDAP {$ldaphost}" );

?>

Exemple 2. Exemple de connexion à un serveur LDAP SSL

<?php

// Assurez-vous que l'hôte est correct
// et que vous avez un certificat valide
$ldaphost = "ldaps://ldap.example.com/";

// Connexion à LDAP
$ldapconn = ldap_connect( $ldaphost )
          or die(
"Impossible de se connecter au serveur LDAP {$ldaphost}" );

?>

Voir aussi ldap_bind().