Faz ligação ao diretório LDAP

# ldap_bind

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

ldap_bind — Faz ligação ao diretório LDAP

### Descrição

function ldap_bind(LDAP\Connection `$ldap`, ?string `$dn` = `null`, #[\SensitiveParameter]?string `$password` = `null`): bool

Faz ligação ao diretório LDAP com DN/RDN e senha especificados.

### Parâmetros

`ldap`

  Uma instância de LDAP\Connection, retornada por ldap_connect().

`dn`

  O nome distinto para conexão. Pode ser DN (nome distinto) ou RDN (nome distinto relativo).

`password`

  A senha associada ao DN.

Se `password` não for especificada ou estiver vazia, haverá uma tentativa de ligação anônima. O parâmetro `dn` também pode ser deixado vazio para uma ligação anônima. Esta definição está em https://tools.ietf.org/html/rfc2251#section-4.2.2

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `ldap` agora espera uma instância de LDAP\Connection; anteriormente, um resource `ldap link` válido era esperado.

### Exemplos

Exemplo #1 Usando ligação LDAP

    <?php

    // usando ligação LDAP
    $ldaprdn  = 'uname';     // DN ou RDN LDAP
    $ldappass = 'password';  // senha associada

    // conexão ao servidor LDAP
    $ldapconn = ldap_connect("ldap://ldap.example.com")
        or die("Não foi possível conecar ao servidor LDAP.");

    if ($ldapconn) {

        // ligando-se ao servidor ldap
        $ldapbind = ldap_bind($ldapconn, $ldaprdn, $ldappass);

        // verifica ligação
        if ($ldapbind) {
            echo "Ligação bem sucedida ao LDAP...";
        } else {
            echo "Falha na ligação ao LDAP...";
        }

    }

    ?>

Exemplo #2 Usando Ligação Anônima ao LDAP

    <?php

    // usando ligação anônima ao LDAP

    // conexão ao servidor LDAP
    $ldapconn = ldap_connect("ldap://ldap.example.com")
        or die("Não foi possível conectar ao servidor LDAP.");

    if ($ldapconn) {

        // ligação anônima
        $ldapbind = ldap_bind($ldapconn);

        if ($ldapbind) {
            echo "Ligação anônima ao LDAP bem sucedida...";
        } else {
            echo "Falha na ligação anônima ao LDAP...";
        }

    }

    ?>

### Veja Também

- ldap_bind_ext() - Faz ligação ao diretório LDAP
- ldap_unbind() - Desliga-se do diretório LDAP

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open