Skip to content

Document how to debug connection issues #3317

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacatoire merged 3 commits into from
Sep 25, 2026
+22 −1
Merged

Document how to debug connection issues #3317

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ed206ea
Document how to debug connection issues
RoSk0 Apr 16, 2024
763a51c
ldap: document the LDAP_OPT_DEBUG_LEVEL levels and fix the debugging …
lacatoire Sep 25, 2026
ae0af6c
ldap: do not list the OpenLDAP debug levels
lacatoire Sep 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion reference/ldap/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -226,7 +226,10 @@
</term>
<listitem>
<simpara>
Specifies a bitwise level for debug traces.
Specifies a bitwise level for debug traces. The traces are written to
<literal>stderr</literal>. The levels are defined by OpenLDAP, in its
<filename>ldap_log.h</filename> header; PHP does not expose them as
constants.
</simpara>
</listitem>
</varlistentry>
Expand Down
18 changes: 18 additions & 0 deletions reference/ldap/functions/ldap-set-option.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -307,6 +307,24 @@ if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2))) {
echo "Failed to set server controls";
}
?>
]]>
</programlisting>
</example>
<example>
<title>Debugging a connection issue</title>
<programlisting role="php">
<![CDATA[
<?php
// A NULL connection sets the option for the whole process (OpenLDAP only).
// Set before ldap_connect(), it also traces the initialization; set later,
// only the operations that follow are traced.
// 7 combines the OpenLDAP levels 1 (trace), 2 (packets) and 4 (arguments).
// The traces are written to stderr, not to the output of the script.
ldap_set_option(null, LDAP_OPT_DEBUG_LEVEL, 7);

$ds = ldap_connect("ldaps://ldap.example.com:636");
ldap_bind($ds);
?>
]]>
</programlisting>
</example>
Expand Down
Loading