diff --git a/reference/ldap/functions/ldap-bind.xml b/reference/ldap/functions/ldap-bind.xml index 5edf63b99..b495512e3 100644 --- a/reference/ldap/functions/ldap-bind.xml +++ b/reference/ldap/functions/ldap-bind.xml @@ -1,5 +1,5 @@ - + @@ -15,9 +15,18 @@ stringnulldn&null; #[\SensitiveParameter]stringnullpassword&null; - + Функция связывает LDAP-каталог с указанным RDN-именем и паролем. - + + + + Эта функция устанавливает фактическое сетевое соединение с LDAP-сервером, + поскольку функция ldap_connect только инициализирует + параметры соединения. Каждую опцию, которая влияет на соединение, например + LDAP_OPT_PROTOCOL_VERSION или опции, связанные с TLS, + требуется установить до вызова этой функции. + + diff --git a/reference/ldap/functions/ldap-connect.xml b/reference/ldap/functions/ldap-connect.xml index b4a223203..37577f639 100644 --- a/reference/ldap/functions/ldap-connect.xml +++ b/reference/ldap/functions/ldap-connect.xml @@ -1,5 +1,5 @@ - + @@ -23,15 +23,27 @@ stringnullhost&null; intport389 - - Создаёт объект LDAP\Connection и проверяет правдоподобность - заданного в параметре uri значения. - + + Создаёт объект класса LDAP\Connection и проверяет + правдоподобность заданного в параметре uri значения. + + + + Эта функция не открывает сетевое соединение. + Она только проверяет синтаксис URI и инициализирует параметры соединения. + Фактическое TCP-соединение устанавливается при вызове функции + ldap_bind. + + - Эта функция не открывает соединение. - Она проверяет, правдоподобны ли заданные параметры и можно - ли, указав их, установить соединение, когда оно необходимо. + Опции, которые влияют на установку соединения, например + LDAP_OPT_PROTOCOL_VERSION и опции, связанные с TLS + (LDAP_OPT_X_TLS_*), требуется установить функцией + ldap_set_option после вызова этой функции и до вызова + функции ldap_bind. Опции, связанные с TLS, + устанавливают глобально — первым аргументом функции + ldap_set_option передают значение &null;. diff --git a/reference/ldap/functions/ldap-set-option.xml b/reference/ldap/functions/ldap-set-option.xml index 35a53a552..b315a5b1e 100644 --- a/reference/ldap/functions/ldap-set-option.xml +++ b/reference/ldap/functions/ldap-set-option.xml @@ -1,5 +1,5 @@ - + @@ -15,9 +15,18 @@ intoption arraystringintboolvalue - + Функция устанавливает для опции значение value. - + + + + Опции, связанные с TLS (LDAP_OPT_X_TLS_*), устанавливают + глобально — в параметре ldap передают значение &null;, + поскольку контекст TLS инициализируется до того, как становится доступно + состояние конкретного соединения. Эти опции требуется установить также + до вызова функции ldap_bind. + +