ldap_bind

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

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

Descrição

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

Example #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...";
    }

}

?>

Example #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