ldap_connect

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

ldap_connect — Conecta a um servidor LDAP

Descrição

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

A partir do PHP 8.3.0, a assinatura a seguir se torna defasada.

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

Cria uma conexão LDAP\Connection e verifica se o uri informado é plausível.

Note: A função não abre uma conexão. Ela verifica se os parâmetros informados são plausíveis e podem ser usados para abrir uma conexão assim que ela for necessária.

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.3.0 Chamar ldap_connect() com hostname e port separados agora está defasado.
8.1.0 Retorna uma instância LDAP\Connection agora; anteriormente, um resource era retornado.

Exemplos

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

?>

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