# ldap_bind

(PHP 4, PHP 5, PHP 7)

ldap_bind — 绑定 LDAP 目录

### 说明

ldap_bind ( resource `$link_identifier` [, string `$bind_rdn` = `NULL` [, string `$bind_password` = `NULL` ]] ) : bool

使用指定的 RDN 和密码绑定到 LDAP 目录。

### 参数

`link_identifier`

  通过 ldap_connect() 连接之后返回的 LDAP 连接标识。

`bind_rdn`

`bind_password`

如果没有指定 `bind_rdn` 和 `bind_password` ，将会以匿名身份绑定。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 范例

Example #1 使用 LDAP Bind

    <?php

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

    // connect to ldap server
    $ldapconn = ldap_connect("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...";
        }

    }

    ?>

Example #2 Using LDAP Bind Anonymously

    <?php

    //using ldap bind anonymously

    // connect to ldap server
    $ldapconn = ldap_connect("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...";
        }

    }

    ?>

### 参见

- ldap_unbind() - Unbind from LDAP directory