com doc/fr: Apply commit 0e06ad7d77756a2f390e14d19b823a42ab65892b: reference/libxml/functions/libxml-set-external-entity-loader.xml

Commit:    980b2ee1a121ff76ab93f55409528e1bd40153d6
Author:    George Peter Banyard <[email protected]>         Wed, 20 Jan 2021 12:12:44 +0000
Parents:   d8c39c3de5c54854749f5033382d1eea703dc5ca
Branches:  master

Link:       http://git.php.net/?p=doc/fr.git;a=commitdiff;h=980b2ee1a121ff76ab93f55409528e1bd40153d6

Log:
Apply commit 0e06ad7d77756a2f390e14d19b823a42ab65892b

Improve libxml_set_external_entity_loader() docs

Changed paths:
  M  reference/libxml/functions/libxml-set-external-entity-loader.xml


Diff:
diff --git a/reference/libxml/functions/libxml-set-external-entity-loader.xml b/reference/libxml/functions/libxml-set-external-entity-loader.xml
index d41589f598..69447bf641 100644
--- a/reference/libxml/functions/libxml-set-external-entity-loader.xml
+++ b/reference/libxml/functions/libxml-set-external-entity-loader.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f90df97fa5ebfa6e7fcace04976900d6700467cc Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 0e06ad7d77756a2f390e14d19b823a42ab65892b Maintainer: jpauli Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.libxml-set-external-entity-loader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -16,6 +16,10 @@
   </methodsynopsis>
   <para>
    Change le chargeur d'entités externes par défaut.
+   Ceci peut être utilisé pour réprimer l'expansion d'entités externes arbitraire
+   pour prévenir les attaques XXE, même si <constant>LIBXML_NOENT</constant> a
+   été définie pour l'opération respective, et ceci est généralement préférable
+   à appeler <function>libxml_disable_entity_loader</function>.
   </para>
  </refsect1>
 
@@ -26,9 +30,43 @@
     <term><parameter>resolver_function</parameter></term>
     <listitem>
      <para>
-      Une <type>callable</type> qui accepte trois arguments. Deux chaines, l'id public et l'id
-      système, et un contexte (un tableau avec quatre clés) comme troisième argument. Cette
-      callback doit retourner une ressource, une chaine servant à ouvrir une ressource ou &null;.
+      Un <type>callable</type> avec la signature suivante :
+      <methodsynopsis>
+       <type class="union"><type>resource</type><type>string</type><type>null</type></type><methodname><replaceable>resolver</replaceable></methodname>
+       <methodparam><type>string</type><parameter>public_id</parameter></methodparam>
+       <methodparam><type>string</type><parameter>system_id</parameter></methodparam>
+       <methodparam><type>array</type><parameter>context</parameter></methodparam>
+      </methodsynopsis>
+      <variablelist>
+       <varlistentry>
+        <term><parameter>public_id</parameter></term>
+        <listitem>
+         <simpara>
+          L'ID public.
+         </simpara>
+        </listitem>
+       </varlistentry>
+       <varlistentry>
+        <term><parameter>system_id</parameter></term>
+        <listitem>
+         <simpara>
+          L'ID système.
+         </simpara>
+        </listitem>
+       </varlistentry>
+       <varlistentry>
+        <term><parameter>context</parameter></term>
+        <listitem>
+         <simpara>
+          Un tableau contenant quatre éléments <literal>"directory"</literal>, <literal>"intSubName"</literal>,
+          <literal>"extSubURI"</literal> et <literal>"extSubSystem"</literal>.
+         </simpara>
+        </listitem>
+       </varlistentry>
+      </variablelist>
+      Cette callable devrait retourner une &resource;, une &string; par laquelle
+      une ressource peut être ouvert. Si &null; est retourné, la résolution de
+      référence d'entité échouera.
      </para>
     </listitem>
    </varlistentry>