(PHP 4, PHP 5, PHP 7)
ldap_connect — Connect to an LDAP server
ldap_connect ([ string|null $uri = null ] ) : resource|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 $host = null [, int $port = 389 ]] ) : resource|false
Creates an LDAP link identifier and checks whether the given
uri is plausible.
Note: 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
ldaps://hostname:port for SSL encryption.
You can also provide multiple LDAP-URIs separated by a space as one string
hostname:port is not a supported LDAP URI as the schema is missing.
The hostname to connect to.
The port to connect to.
Returns a positive LDAP link identifier 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 resource as it does not actually connect but just initializes the connecting parameters. The actual connect happens with the next calls to ldap_* funcs, usually with ldap_bind().
If no argument is specified then the link identifier of the already opened link will be returned.
Example #1 Example of connecting to LDAP server.
<?php // 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"); ?>
Example #2 Example of connecting securely to LDAP server.
<?php // 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"); ?>
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.