ldap_connect

ldap_connect

Conexión a un servidor LDAP

Descripción#

ldap_connect([string $uri]): LDAP\Connection
```php

> [!WARNING]
> A partir de PHP 8.3.0, la firma *siguiente* está obsoleta.

```php
ldap_connect([string $host], [int $port]): LDAP\Connection

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

[!NOTE] 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#

Ejemplos#

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 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");

?>

Véase también#

ldap_bind