# ldap_connect

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

ldap_connect — Connect to an LDAP server

### 说明

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

As of PHP 8.3.0, the following signature is deprecated.

ldap_connect(?string `$host` = `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.

### 参数

`uri`

  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.

`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");
?>`

### 参见

- ldap_bind() - 绑定 LDAP 目录

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open