Connexion à un serveur LDAP

# ldap_connect

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

ldap_connect — Connexion à un serveur LDAP

### Description

function ldap_connect(?string `$uri` = `null`): LDAP\Connection|false
Avertissement

À partir de PHP 8.3.0, la signature suivante est obsolète.

function ldap_connect(?string `$host` = `null`, int `$port` = 389): LDAP\Connection|false

Crée une instance LDAP\Connection et vérifie si l'`uri` donnée est plausible.

> Note: Cette fonction n'ouvre pas de connexion. Elle vérifie si les paramètres donnés sont plausibles et peuvent être utilisés pour ouvrir une connexion dès qu'on en a besoin.

### Liste de paramètres

`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.

`host`

  Le nom d'hôte à se connecter.

`port`

  Le port utilisé pour la connexion.

### Valeurs de retour

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.

### Historique

Version | Description
--- | ---
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.

### Exemples

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");

    ?>

### Voir aussi

- ldap_bind() - Authentification au serveur LDAP

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open