array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ldap-connect.php', 1 => 'ldap_connect', 2 => 'Conecta a um servidor LDAP', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'Funções do LDAP', ), 'prev' => array ( 0 => 'function.ldap-compare.php', 1 => 'ldap_compare', ), 'next' => array ( 0 => 'function.ldap-connect-wallet.php', 1 => 'ldap_connect_wallet', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ldap/functions/ldap-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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
Aviso

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

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.

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.

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 foi descontinuado.
8.1.0 Retorna uma instância LDAP\Connection agora; anteriormente, um resource era retornado.

Exemplos

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