Php/docs/function.ldap-connect

来自菜鸟教程
跳转至:导航、​搜索

ldap_connect

(PHP 4, PHP 5, PHP 7)

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

参见