Skip to content

[Sync-En] ldap: document how to debug connection issues #3594

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 1 commit into from
Sep 26, 2026
+44 −20
Merged

[Sync-En] ldap: document how to debug connection issues #3594

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
43 changes: 24 additions & 19 deletions reference/ldap/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c048a5adc2726c0e5b68c5d7d8751e9854b6f637 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 9ade3ccfc8f1fa82f116a2b2c1e5e3f516fb11e7 Maintainer: lacatoire Status: ready -->

<appendix xml:id="ldap.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
Expand Down Expand Up @@ -66,14 +66,15 @@
(<type>int</type>)
</term>
<listitem>
<para>
<para>
Spécifie le nombre maximum d'entrées qui peuvent être retournées
d'une position de recherche.
lors d'une opération de recherche.
</para>
<note>
<simpara>
La limite réelle peut aussi être donnée du côté du serveur.
La plus petite des deux sera celle utilisée.
La limite réelle est également bornée par le nombre maximum d'entrées
retournées configuré sur le serveur.
La plus petite de ces deux valeurs est la limite réelle.
</simpara>
</note>
</listitem>
Expand All @@ -89,8 +90,9 @@
</simpara>
<note>
<simpara>
La limite réelle peut aussi être donnée du côté du serveur.
La plus petite des deux sera celle utilisée.
La limite réelle est également bornée par la durée maximum configurée
sur le serveur.
La plus petite de ces deux valeurs est la limite réelle.
</simpara>
</note>
</listitem>
Expand Down Expand Up @@ -202,7 +204,7 @@
</term>
<listitem>
<simpara>
Spécifie une liste de contrôles serveurs à envoyer avec chaque requête.
Spécifie une liste par défaut de contrôles serveurs à envoyer avec chaque requête.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -213,7 +215,7 @@
</term>
<listitem>
<simpara>
Spécifie une liste de contrôles clients à envoyer avec chaque requête.
Spécifie une liste par défaut de contrôles clients à traiter avec chaque requête.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -225,6 +227,9 @@
<listitem>
<simpara>
Spécifie un niveau pour les traces de débogage, sous forme de masque de bits.
Les traces sont écrites sur <literal>stderr</literal>. Les niveaux sont
définis par OpenLDAP, dans son en-tête <filename>ldap_log.h</filename> ;
PHP ne les expose pas sous forme de constantes.
</simpara>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -547,7 +552,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Filtre valeur retourné (<link xlink:href="&url.rfc;3876">RFC 3876</link>).
Constante de contrôle - Filtre des valeurs retournées (<link xlink:href="&url.rfc;3876">RFC 3876</link>).
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand Down Expand Up @@ -631,7 +636,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Demande d'Autorisation d'Identité (<link xlink:href="&url.rfc;3829">RFC 3829</link>).
Constante de contrôle - Demande d'identité d'autorisation (<link xlink:href="&url.rfc;3829">RFC 3829</link>).
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand All @@ -643,7 +648,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Réponse d'Autorisation d'Identité (<link xlink:href="&url.rfc;3829">RFC 3829</link>).
Constante de contrôle - Réponse d'identité d'autorisation (<link xlink:href="&url.rfc;3829">RFC 3829</link>).
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand Down Expand Up @@ -691,7 +696,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - N'utiliser pas Copier (<link xlink:href="&url.rfc;6171">RFC 6171</link>).
Constante de contrôle - Ne pas utiliser la copie (<link xlink:href="&url.rfc;6171">RFC 6171</link>).
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand Down Expand Up @@ -739,7 +744,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Portée du domaine d'Active Directory
Constante de contrôle - Portée du domaine d'Active Directory.
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand All @@ -751,7 +756,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Permission de modification d'Active Directory.
Constante de contrôle - Modification permissive d'Active Directory.
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand All @@ -763,7 +768,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Option de recherche d'Active Directory.
Constante de contrôle - Options de recherche d'Active Directory.
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand All @@ -787,7 +792,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Dossier actif étendu DN.
Constante de contrôle - DN étendu d'Active Directory.
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand All @@ -799,7 +804,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Liste Virtuelle de Requête de Vue.
Constante de contrôle - Requête de vue de liste virtuelle.
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand All @@ -811,7 +816,7 @@
</term>
<listitem>
<simpara>
Constante de contrôle - Liste Virtuelle de Réponse de Vue.
Constante de contrôle - Réponse de vue de liste virtuelle.
&php.version.added; 7.3.0.
</simpara>
</listitem>
Expand Down
21 changes: 20 additions & 1 deletion reference/ldap/functions/ldap-set-option.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c048a5adc2726c0e5b68c5d7d8751e9854b6f637 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 9ade3ccfc8f1fa82f116a2b2c1e5e3f516fb11e7 Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.ldap-set-option" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>ldap_set_option</refname>
Expand Down Expand Up @@ -298,6 +298,7 @@ if (ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3)) {
<![CDATA[
<?php
// $ds doit être une instance de connexion LDAP\Connection valide
// contrôle sans valeur
$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => true);
// iscritical vaut par défaut FALSE
$ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic");
Expand All @@ -306,6 +307,24 @@ if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2))) {
echo "Impossible de modifier les contrôles du serveur";
}
?>
]]>
</programlisting>
</example>
<example>
<title>Débogage d'un problème de connexion</title>
<programlisting role="php">
<![CDATA[
<?php
// Une connexion NULL définit l'option pour tout le processus (OpenLDAP uniquement).
// Définie avant ldap_connect(), elle trace aussi l'initialisation ; définie plus
// tard, seules les opérations qui suivent sont tracées.
// 7 combine les niveaux OpenLDAP 1 (trace), 2 (paquets) et 4 (arguments).
// Les traces sont écrites sur stderr, et non dans la sortie du 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