array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.ldap-connect.php', 1 => 'ldap_connect', 2 => 'Connexion à un serveur LDAP', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'Fonctions LDAP', ), 'prev' => array ( 0 => 'function.ldap-compare.php', 1 => 'ldap_compare', ), 'next' => array ( 0 => 'function.ldap-connect-wallet.php', 1 => 'ldap_connect_wallet', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/ldap/functions/ldap-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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