ldap_connect

(PHP 4, PHP 5, PHP 7)

ldap_connectAbre una conexión a un servidor LDAP

Descripción

ldap_connect ([ string $hostname = NULL [, int $port = 389 ]] ) : resource

Establece una conexión con un servidor LDAP en un determinado hostname and port.

Parámetros

hostname

Si se está usando OpenLDAP 2.x.x se puede especificar una URL en lugar del host. Para usar LDAP con SSL, se debe compilar OpenLDAP 2.x.x con soporte para SSL, configurar PHP con SSL y colocar este parámetro como ldaps://hostname/.

port

El puerto al cual debe conectarse. No se usa cuando se está usando URLs.

Valores devueltos

Devuelve un identificador de enlace al LDAP en caso de éxito o FALSE en caso de error. Cuando se está usando OpenLDAP 2.x.x, ldap_connect() devolverá siempre un resource que no es la conexión en sí sino solo inicialización de los parámetros de conexión. La conexión real se realizará en la siguiente llamada a las funciones ldap_*, por lo general ldap_bind().

Si no se especificaron parámetros, será retornado el identificador de enlace de la conexión activa.

Ejemplos

Ejemplo #1 Ejemplo de conexión a un servidor LDAP.

<?php

// Variables del servidor LDAP
$ldaphost "ldap.example.com";  // servidor LDAP
$ldapport 389;                 // puerto del servidor LDAP

// Conexión al servidor LDAP
$ldapconn ldap_connect($ldaphost$ldapport)
          or die(
"Could not connect to $ldaphost");

?>

Ejemplo #2 Ejemplo de conexión segura a un servidor LDAP.

<?php

// Asegúrese de que el host sea el que fue publicado
// con su certificado
$ldaphost "ldaps://ldap.example.com/";

// Conexión al servidor LDAP
$ldapconn ldap_connect($ldaphost)
          or die(
"Could not connect to {$ldaphost}");

?>

Ver también

  • ldap_bind() - Realiza la autenticación con un servidor LDAP