Skip to content

[Sync-EN] Clarify ldap_connect(), ldap_bind() and ldap_set_option() behavior - #1795

Open
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/1651
Open

[Sync-EN] Clarify ldap_connect(), ldap_bind() and ldap_set_option() behavior#1795
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/1651

Conversation

@lacatoire

Copy link
Copy Markdown
Member

Syncs the three reference/ldap/functions/ pages with php/doc-en#5275.

  • ldap_connect(): says explicitly that it opens no network connection, only validating the URI and initializing connection parameters, the TCP connection being established by ldap_bind(). A second note states that connection-setup options, LDAP_OPT_PROTOCOL_VERSION and the LDAP_OPT_X_TLS_* family, must be set between ldap_connect() and ldap_bind(), the TLS ones globally.
  • ldap_bind(): gains the matching note, that it is the call establishing the connection, so connection-affecting options must be set beforehand.
  • ldap_set_option(): gains the note that LDAP_OPT_X_TLS_* options must be set globally by passing null as ldap, because the TLS context is initialized before the per-connection state exists, and before ldap_bind().

EN-Revision bumped to 87d63aa1a3fc86d64dc994332042fdd2c13bf3d8 on the three files.

Fixes: #1651

@lacatoire
lacatoire requested a review from a team as a code owner August 31, 2026 11:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Sync EN] Clarify ldap_connect/ldap_bind/ldap_set_option behavior

1 participant