PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Connexion à un serveur LDAP
À partir de PHP 8.3.0, la signature suivante est obsolète.
Crée une instance LDAP\Connection et vérifie si
l'uri donnée est plausible.
Note:
Cette fonction n'ouvre pas de connexion réseau. Elle valide uniquement la syntaxe de l'URI et initialise les paramètres de connexion. La connexion TCP réelle est établie lors de l'appel à ldap_bind().
Note:
Les options qui affectent la configuration de la connexion, telles que
LDAP_OPT_PROTOCOL_VERSIONet les options liées à TLS (LDAP_OPT_X_TLS_*), doivent être définies via ldap_set_option() après l'appel à cette fonction et avant l'appel à ldap_bind(). Les options liées à TLS doivent être définies globalement (en passantnullcomme premier argument à ldap_set_option()).
uri
Un URI LDAP complet de la forme LDAP://hostname:port
ou LDAPS://hostname:port pour le chiffrement SSL.
Il est également possible de fournir plusieurs URI LDAP séparés par un espace comme une chaîne
À noter que hostname:port n'est pas un URI LDAP pris en
charge car le schéma est manquant.
hostLe nom d'hôte à se connecter.
portLe port utilisé pour la connexion.
Retourne une instance de LDAP\Connection lorsque
l'URI LDAP semble plausible. Il s'agit d'un contrôle syntaxique des paramètres fournis,
mais le serveur(s) ne sera pas contacté !
Si la vérification syntaxique échoue, elle retourne false.
ldap_connect() retourne sinon une instance de
LDAP\Connection car elle 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().
Sans argument, alors l'instance LDAP\Connection de la dernière connexion déjà ouverte est retournée.
| Version | Description |
|---|---|
| 8.5.0 | Appeler ldap_connect() avec des arguments de wallet Oracle est obsolète. Le support d'Oracle LDAP (Oracle Instant Client) est obsolète à partir de PHP 8.5.0. |
| 8.4.0 | Appeler ldap_connect() avec plus de deux arguments est désormais obsolète. |
| 8.3.0 |
Appeler ldap_connect() avec
hostname et port
séparés est désormais obsolète.
|
| 8.1.0 | Retourne désormais une instance de LDAP\Connection ; auparavant, une resource était retournée. |
Exemple #1 Exemple de connexion à un serveur LDAP
<?php
// LDAP variables
$ldapuri = "ldap://ldap.example.com:389"; // votre ldap-uri
// Connexion LDAP
$ldapconn = ldap_connect($ldapuri)
or die("Cette LDAP-URI n'a pas pu être analysée");
?>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("Cette LDAP-URI n'a pas été analysable");
?>