Php/docs/function.ldap-connect
ldap_connect
(PHP 4, PHP 5, PHP 7)
ldap_connect — Connect to an LDAP server
说明
ldap_connect
([ string $ldap_uri
= null
] ) : resource
Warning The following signature is still supported for backwards compatibility, but is considered deprecated and should not be used anymore!
ldap_connect
([ string $host
= null
[, int $port
= 389
]] ) : resource
Creates an LDAP link identifier and checks whether the given
host
and port
are 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.
参数
ldap_uri
A full LDAP URI of the form
ldap://hostname:port
orldaps://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.host
The hostname to connect to.
port
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");?>