ldap_connect

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.

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().