# ldap_connect

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_connect — Abre 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