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

    VersionDescription
    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 ressource é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

    To Top