# ldap_bind

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_bind — Authentification au serveur LDAP

### Description

ldap_bind(LDAP\Connection `$ldap`, ?string `$dn` = `null`, #[\SensitiveParameter] ?string `$password` = `null`): bool

Authentification au serveur LDAP avec le RDN et le mot de passe spécifiés.

### Liste de paramètres

`ldap`

  Une instance LDAP\Connection, retourné par ldap_connect().

`dn`

`password`

Si `password` n'est pas spécifié ou est vide, une authentification anonyme est essayée. `dn` peut également être laissé vide pour une liaison anonyme. Ceci est défini dans https://tools.ietf.org/html/rfc2251#section-4.2.2

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `ldap` attend désormais une instance de LDAP\Connection ; auparavant, une resource `ldap link` était attendue.

### Exemples

Exemple #1 Authentification avec LDAP

`<?php
// Eléments d'authentification LDAP
$ldaprdn = 'uname'; // DN ou RDN LDAP
$ldappass = 'password'; // Mot de passe associé
// Connexion au serveur LDAP
$ldapconn = ldap_connect("ldap://ldap.example.com")
or die("Impossible de se connecter au serveur LDAP.");
if ($ldapconn) {
// Connexion au serveur LDAP
$ldapbind = ldap_bind($ldapconn, $ldaprdn, $ldappass);
// Vérification de l'authentification
if ($ldapbind) {
echo "Connexion LDAP réussie...";
} else {
echo "Connexion LDAP échouée...";
}
}
?>`

Exemple #2 Connexion anonyme à un serveur LDAP

`<?php
// Connexion anonyme à un serveur LDAP
// Connexion au serveur LDAP
$ldapconn = ldap_connect("ldap://ldap.example.com")
or die("Impossible de se connecter au serveur LDAP.");
if ($ldapconn) {
// Authentification anonyme
$ldapbind = ldap_bind($ldapconn);
if ($ldapbind) {
echo "Connexion LDAP anonyme réussie...";
} else {
echo "Connexion LDAP anonyme échouée...";
}
}
?>`

### Voir aussi

- ldap_bind_ext() - Lie un dossier LDAP
- ldap_unbind() - Déconnecte d'un serveur LDAP