PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Conexión a un servidor LDAP
A partir de PHP 8.3.0, la firma siguiente está obsoleta.
Crea una instancia LDAP\Connection y verifica si
el uri proporcionado es plausible.
Nota:
Esta función no abre una conexión de red. Solo valida la sintaxis del URI e inicializa los parámetros de conexión. La conexión TCP real se establece cuando se llama a ldap_bind().
Nota:
Las opciones que afectan a la configuración de la conexión, como
LDAP_OPT_PROTOCOL_VERSIONy las opciones relacionadas con TLS (LDAP_OPT_X_TLS_*), deben establecerse con ldap_set_option() después de llamar a esta función y antes de llamar a ldap_bind(). Las opciones relacionadas con TLS deben establecerse globalmente (pasandonullcomo primer argumento a ldap_set_option()).
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.
hostEl nombre de host al que conectarse.
portEl puerto utilizado para la conexión.
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.
| Versión | Descripción |
|---|---|
| 8.5.0 | Llamar a ldap_connect() con argumentos de wallet de Oracle está obsoleto. El soporte de Oracle LDAP (Oracle Instant Client) está obsoleto a partir de PHP 8.5.0. |
| 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. |
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");
?>