PHP: ldap_connect

Descrição

function ldap_connect(?string $uri = null): LDAP\Connection|false

Aviso

A partir do PHP 8.3.0, a assinatura a seguir foi descontinuada.

function ldap_connect(?string $host = null, int $port = 389): LDAP\Connection|false

Cria uma instância LDAP\Connection e verifica se o uri informado é plausível.

Nota:
Esta função não abre uma conexão de rede. Ela apenas verifica a sintaxe da URI e inicializa os parâmetros de conexão. A conexão TCP real é estabelecida quando ldap_bind() é chamada.

Nota:
Opções que afetam a configuração da conexão, como LDAP_OPT_PROTOCOL_VERSION e opções relacionadas ao TLS (LDAP_OPT_X_TLS_*), precisam ser definidas usando ldap_set_option() após chamar esta função e antes de chamar ldap_bind(). Opções relacionadas ao TLS devem ser definidas globalmente (passando null como o primeiro argumento para ldap_set_option()).

Parâmetros

uri

Uma URI LDAP completa na forma ldap://hostname:port ou ldaps://hostname:port para criptografia SSL.

Pode-se também informar múltiplas URIs LDAP separadas por um espaço como uma string

Observe que hostname:port não é um URI LDAP suportada pois não contém o esquema.

host

O servidor para conexão.

port

A porta para conexão.

Valor Retornado

Retorna uma instância LDAP\Connection quando a URI LDAP informada parece plausível. É uma verificação sintática do parâmetro fornecido mas o(s) servidor(es) não serão contactados! Se a verificação sintática falhar será retornado false. ldap_connect() irá retornar uma instância LDAP\Connection já que ela não conecta realmente mas somente inicializa os parâmetros de conexão. A conexão real acontece com as próximas chamadas às funções ldap_*, normalmente com ldap_bind().

Se nenhum argumento for especificado, a instância LDAP\Connection da conexão já aberta será retornada.

Registro de Alterações

Versão	Descrição
8.4.0	Chamar ldap_connect() com mais de dois argumentos foi descontinuado.
8.3.0	Chamar ldap_connect() com `hostname` e `port` separados agora foi descontinuado.
8.1.0	Retorna uma instância LDAP\Connection agora; anteriormente, um resource era retornado.

Examples

Exemplo #1 Exemplo de conexão a um servidor LDAP.

<?php

// Variáveis LDAP
$ldapuri = "ldap://ldap.example.com:389";  // URI LDAP

// Conexão ao LDAP
$ldapconn = ldap_connect($ldapuri)
          or die("Não foi possível interpretar a URI LDAP.");

?>

Exemplo #2 Exemplo de conexão segura a um servidor LDAP.

<?php

// confirme que o servidor é o correto,
// aquele para o qual o certificado seguro foi emitido
$ldaphost = "ldaps://ldap.example.com/";

// Conectando ao LDAP
$ldapconn = ldap_connect($ldaphost)
          or die("Não foi possível interpretar a URI LDAP.");

?>

Veja também

ldap_bind() - Faz ligação ao diretório LDAP