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

ldap_connectConnect to an LDAP server


ldap_connect(?string $uri = null): LDAP\Connection|false

The following signature is still supported for backwards compatibility (except for using named parameters), but is considered deprecated and should not be used anymore!

ldap_connect(?string $uri = null, int $port = 389): LDAP\Connection|false

Creates an LDAP\Connection connection and checks whether the given uri is plausible.

注意: This function does not open a connection. It checks whether the given parameters are plausible and can be used to open a connection as soon as one is needed.



A full LDAP URI of the form ldap://hostname:port or ldaps://hostname:port for SSL encryption.

You can also provide multiple LDAP-URIs separated by a space as one string

Note that hostname:port is not a supported LDAP URI as the schema is missing.


The hostname to connect to.


The port to connect to.


Returns an LDAP\Connection instance when the provided LDAP URI seems plausible. It's a syntactic check of the provided parameter but the server(s) will not be contacted! If the syntactic check fails it returns false. ldap_connect() will otherwise return a LDAP\Connection instance as it does not actually connect but just initializes the connecting parameters. The actual connect happens with the next calls to ldap_* functions, usually with ldap_bind().

If no argument is specified then the LDAP\Connection instance of the already opened connection will be returned.


版本 说明
8.1.0 Returns an LDAP\Connection instance now; previously, a 资源(resource) was returned.


示例 #1 Example of connecting to LDAP server.


// LDAP variables
$ldapuri "ldap://ldap.example.com:389";  // your ldap-uri

// Connecting to LDAP
$ldapconn ldap_connect($ldapuri)
          or die(
"That LDAP-URI was not parseable");


示例 #2 Example of connecting securely to LDAP server.


// make sure your host is the correct one
// that you issued your secure certificate to
$ldaphost "ldaps://ldap.example.com/";

// Connecting to LDAP
$ldapconn ldap_connect($ldaphost)
          or die(
"That LDAP-URI was not parseable");