(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Conecta a um servidor LDAP
A partir do PHP 8.3.0, a assinatura a seguir foi descontinuada.
Cria uma conexão LDAP\Connection e verifica se o
uri
informado é plausível.
Nota: 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.
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.
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.
Versão | Descrição |
---|---|
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. |
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.");
?>