Conecta a um servidor LDAP

# ldap_connect

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

ldap_connect — Conecta a um servidor LDAP

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

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open