ldap_connect

ldap_connect

(PHP 3, PHP 4, PHP 5)

ldap_connect -- Conecta con un servidor LDAP

Descripci贸n

resource ldap_connect ( [string nombre_host [, int puerto]] )

Devuelve un identificador de conexi贸n positivo en caso de 茅xito, 贸 falso si ocurre alg煤n error. Cuando se emplea un servidor OpenLDAP versi贸n 2.x.x, la funci贸n ldap_connect() siempre devuelve una variable de tipo resource ya que en realidad no se realiza la conexi贸n, sino que se inicializan los par谩metros de conexi贸n. La conexi贸n real se produce cuando se realiza la llamada a la siguiente funci贸n ldap_* funcs, que normalmente es la funci贸n ldap_bind().

ldap_connect() establece una conexi贸n con el servidor LDAP especificado en nombre_host y puerto. Ambos argumentos son opcionales. Si no se especifican, se devuelve el identificador de la conexi贸n LDAP actualmente abierta. Si s贸lo es especificado nombre_host el puerto tomado por defecto es el 389.

Si se emplea un servidor OpenLDAP versi贸n 2.x.x, se puede especificar una URL en vez de un nombre de host. Para utilizar LDAP con SSL, se tiene que compilar OpenLDAP con soporte SLL, configurar PHP para que utilice SSL y usar como nombre de host "ldaps://hostname/". El par谩metro puerto no se tiene en cuenta cuando se utilizan URLs.

Nota: El soporte de URLs y de SLL se incluy贸 en la versi贸n 4.0.4.

Ejemplo 1. Ejemplo de conxi贸n a un servidor LDAP.

<?php

// variables LDAP
$servidor_ldap = "ldap.example.com";  // el servidor LDAP al que se quiere conectar
$puerto_ldap   = 389;                 // el puerto al que se conectara

// Estableciendo la conexion con el servidor LDAP
$conexion_ldap = ldap_connect($servidor_ldap, $puerto_ldap)
          or die(
"No ha sido posible conectarse al servidor $servidor_ldap");

?>

Ejemplo 2. Ejemplo de conxi贸n a un servidor LDAP seguro.

<?php

// Debe tenerse en cuenta que el sistema que quiere conectarse al servidor
// debe coincidir con el equipo al que se genero el certificado seguro

$servidor_ldap = "ldaps://ldap.example.com/";

// Estableciendo la conexion con el servidor LDAP seguro
$conexion_ldap = ldap_connect($servidor_ldap)
          or die(
"No ha sido posible conectarse al servidor {$servidor_ldap}");

?>

Vea tambi茅n ldap_bind().