ldap_connect

(PHP 4, PHP 5, PHP 7)

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

Описание

ldap_connect ([ string $ldap_uri = NULL ] ) : resource
Внимание

Следующий синтаксис все еще поддерживается для обеспечения обратной совместимости, но он объявлен устаревшим и больше не должен использоваться!

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

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

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

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

ldap_uri

Полный LDAP URI вида ldap://hostname:port или ldaps://hostname:port.

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

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

host

Имя сервера для соединения.

port

Порт для соединения.

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

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

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

Примеры

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

<?php

// LDAP переменные
$ldapuri "ldap://ldap.example.com:389";  // ldap-uri

// Соединение с LDAP
$ldapconn ldap_connect($ldapuri)
          or die(
"LDAP-URI некорректен");

?>

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

<?php

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

// Соединение с LDAP
$ldapconn ldap_connect($ldaphost)
          or die(
"LDAP-URI некорректен");

?>

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

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