Conexión a un servidor LDAP

# ldap_connect

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

ldap_connect — Conexión a un servidor LDAP

### Descripción

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

A partir de PHP 8.3.0, la firma siguiente está obsoleta.

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

Crea una instancia LDAP\Connection y verifica si el `uri` proporcionado es plausible.

> Nota: Esta función no abre ninguna conexión. Verifica si los parámetros dados son plausibles y pueden ser utilizados para abrir una conexión cuando sea necesario.

### Parámetros

`uri`

  Un URI LDAP completo de la forma `LDAP://hostname:port` o `LDAPS://hostname:port` para el cifrado SSL.

  También puede proporcionarse varios URI LDAP separados por un espacio como una cadena

  Tenga en cuenta que `hostname:port` no es un URI LDAP soportado ya que falta el esquema.

`host`

  El nombre de host al que conectarse.

`port`

  El puerto utilizado para la conexión.

### Valores devueltos

Devuelve una instancia de LDAP\Connection cuando el URI LDAP parece plausible. Se trata de un control sintáctico de los parámetros proporcionados, pero el servidor(s) no será contactado. Si la verificación sintáctica falla, devuelve `false`. ldap_connect() devolverá entonces una instancia de LDAP\Connection ya que no se conectará pero solo inicializará los parámetros de conexión. Actualmente, la conexión se realiza con la siguiente llamada a las funciones `ldap_*`, habitualmente con la función ldap_bind().

Sin argumentos, entonces se devolverá la instancia LDAP\Connection de la última conexión ya abierta.

### Historial de cambios

Versión | Descripción
--- | ---
8.4.0 | Llamar a ldap_connect() con más de dos argumentos está ahora obsoleto.
8.3.0 | Llamar a ldap_connect() con `hostname` y `port` separados está ahora obsoleto.
8.1.0 | Ahora devuelve una instancia de LDAP\Connection ; anteriormente, se esperaba una resource.

### Ejemplos

Ejemplo #1 Ejemplo de conexión a un servidor LDAP

    <?php

    // Variables LDAP
    $ldapuri = "ldap://ldap.example.com:389";  // su ldap-uri

    // Conexión LDAP
    $ldapconn = ldap_connect($ldaphost, $ldapport)
              or die("Esta LDAP-URI no ha sido analizable");

    ?>

Ejemplo #2 Ejemplo de conexión a un servidor LDAP SSL

    <?php

    // Asegúrese de que el host es correcto
    // y que tiene un certificado válido
    $ldaphost = "ldaps://ldap.example.com/";

    // Conexión LDAP
    $ldapconn = ldap_connect($ldaphost)
              or die("Esta LDAP-URI no ha sido analizable");

    ?>

### Ver también

- ldap_bind() - Autenticación en el servidor LDAP

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