ldap_connect

(PHP 4, PHP 5, PHP 7)

ldap_connectConnexion à un serveur LDAP

Description

ldap_connect ([ string $ldap_uri = NULL ] ) : resource
Avertissement

la signature suivante est toujours supporté pour la rétrocompatibilité, mais est considéré obsoléte et ne devrait plus être utilisé!

ldap_connect ([ string $host = NULL [, int $port = 389 ]] ) : resource

Crée un identificateur de liaison LDAP et vérifie si l'host et le port donnés sont plausibles.

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

Liste de paramètres

ldap_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

Renvoie un identificateur de liaison LDAP positif 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 ressource car il 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, l'identifiant de la dernière connexion ouverte sera retourné.

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