Home/ Manual/ ldap / functions/ ldap_bind

ldap_bind

PHP function Edit on GitHub ✎

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

Bind to LDAP directory

Description

ldap_bind(LDAP\Connection $ldap, string|null $dn = null, string|null $password = null): bool

Binds to the LDAP directory with specified RDN and password.

Note

This function establishes the actual network connection to the LDAP server (since ldap_connect() only initializes connection parameters). Any options that affect the connection, such as LDAP_OPT_PROTOCOL_VERSION or TLS-related options, must be set before calling this function.

Parameters

ldap: Ldap
dn
password

If password is not specified or is empty, an anonymous bind is attempted. The dn can also be left empty for an anonymous bind. This is defined in https://tools.ietf.org/html/rfc2251#section-4.2.2

Return Values

Success

Changelog

Version	Description

Examples

Using LDAP Bind

php

<?php

// using ldap bind
$ldaprdn  = 'uname';     // ldap rdn or dn
$ldappass = 'password';  // associated password

// connect to ldap server
$ldapconn = ldap_connect("ldap://ldap.example.com")
    or die("Could not connect to LDAP server.");

if ($ldapconn) {

    // binding to ldap server
    $ldapbind = ldap_bind($ldapconn, $ldaprdn, $ldappass);

    // verify binding
    if ($ldapbind) {
        echo "LDAP bind successful...";
    } else {
        echo "LDAP bind failed...";
    }

}

?>

Using LDAP Bind Anonymously

php

<?php

//using ldap bind anonymously

// connect to ldap server
$ldapconn = ldap_connect("ldap://ldap.example.com")
    or die("Could not connect to LDAP server.");

if ($ldapconn) {

    // binding anonymously
    $ldapbind = ldap_bind($ldapconn);

    if ($ldapbind) {
        echo "LDAP bind anonymous successful...";
    } else {
        echo "LDAP bind anonymous failed...";
    }

}

?>