ldap_connect

(PHP 4, PHP 5, PHP 7)

ldap_connectПодключиться к серверу LDAP

Описание

resource ldap_connect ([ string $host = NULL [, int $port = 389 ]] )

Создает идентификатор соединения LDAP и проверяет правдоподобность заданных hostname и port.

Обратите внимание: Эта функция НЕ открывает соединение. Она проверяет, правдоподобны ли заданные параметры и могут ли они использоваться для подключения, когда в нем возникнет нужна.

Список параметров

hostname

Это поле поддерживает использование имени хоста или, при использовании OpenLDAP 2.x.x и выше, полный URI в формате ldap://hostname:port или ldaps://hostname/.

Также, вы можете указать несколько LDAP-URI разделенных пробелом.

Обратите внимание, что hostname:port - это неподдерживаемый LDAP URI, так как отсутствует схема.

port

Порт для соединения. Не применяется, в случае использования URL.

Возвращаемые значения

Возвращает положительный идентификатор ссылки LDAP если заданая комбирания имени хоста и порта или LDAP URI правдоподобны. Она производит синтаксический разбор и проверку переданных параметров, но соединения с сервером не происходит. Если проверка синтаксиса провалилась - возвращается FALSE. Когда используется OpenLDAP 2.x.x, ldap_connect() будет всегда возвращать resource, поскольку она фактически не соединяется, а только инициализирует параметры соединения. Фактическое подключение происходит при последующих вызовах ldap_* функций, обычно при вызове ldap_bind().

Если никакие параметры не будут определены, тогда будет возвращен идентификатор уже открытой ссылки.

Примеры

Пример #1 Пример подключения к серверу LDAP.

<?php

// LDAP переменные
$ldaphost "ldap.example.com";  // Ваш сервер ldap
$ldapport 389;                 // Порт вашего сервера ldap

// Соединение с LDAP
$ldapconn ldap_connect($ldaphost$ldapport)
          or die(
"Невозможно соединиться с $ldaphost");

?>

Пример #2 Пример безопасного подключения к серверу LDAP.

<?php

// убедитесь, что ваш хост корректный и
// что вы выдали ему сертификат безопасности
$ldaphost "ldaps://ldap.example.com/";

// Соединение с LDAP
$ldapconn ldap_connect($ldaphost)
          or die(
"Невозможно соединиться с {$ldaphost}");

?>

Смотрите также

  • ldap_bind() - Привязать к LDAP директории