(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.
host
El nombre de host al que conectarse.
port
El 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 recurso. |
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");
?>