ldap_connect

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

ldap_connectConexión a un servidor LDAP

Descripción

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

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

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

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