ldap_connect
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Connect to an LDAP server
说明
As of PHP 8.3.0, the following signature is deprecated.
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.
参数
uri-
A full LDAP URI of the form
ldap://hostname:portorldaps://hostname:portfor SSL encryption.You can also provide multiple LDAP-URIs separated by a space as one string
Note that
hostname:portis not a supported LDAP URI as the schema is missing. host-
The hostname to connect to.
port-
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.3.0 |
Calling ldap_connect() with separate
hostname and port
is now deprecated.
|
| 8.1.0 | Returns an LDAP\Connection instance now; previously, a resource was returned. |
示例
示例 #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");
?>示例 #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");
?>