(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 ninguna conexión. Verifica si los parámetros dados son plausibles y pueden ser utilizados para abrir una conexión cuando sea necesario.
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.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");
?>