# ldap_connect

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

ldap_connect — Connexion à un serveur LDAP

### Description

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

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

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

  Vous pouvez également fournir plusieurs URI LDAP séparés par un espace comme une chaîne

  Notez 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() retournera 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 sera retourné.

### Historique

Version | Description
--- | ---
8.3.0 | Appeler ldap_connect() avec `hostname` et `port` séparé est désormais obsolète.
8.1.0 | Retourne désormais une instance de LDAP\Connection ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Exemple de connexion à un serveur LDAP

`<?php
// LDAP variables
$ldapuri = "ldap://ldap.example.com:389"; // voter ldap-uri
// Connexion LDAP
$ldapconn = ldap_connect($ldaphost, $ldapport)
or die("Cette LDAP-URI n'a pas été analysable");
?>`

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