Sync doc with En

git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@322687 c90b9560-bf6c-de11-be94-00142212c4b1
2026-03-23 22:52:18 +01:00 · 2012-01-24 17:43:55 +00:00
parent f80ff74af9
commit 9ae37ce1b7
13 changed files with 5624 additions and 5498 deletions
--- a/appendices/ini.core.xml
+++ b/appendices/ini.core.xml
--- a/appendices/ini.list.xml
+++ b/appendices/ini.list.xml
--- a/appendices/ini.sections.xml
+++ b/appendices/ini.sections.xml
@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: b9c3ddd1d3cdafeed32eae54229151f221d13d6d Maintainer: jpauli Status: ready -->
+<!-- Reviewed: no -->
+
+ <section xml:id="ini.sections" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <title>Liste des sections du fichier &php.ini;</title>
+  <para>
+   Cette liste inclut les sections du &php.ini; que vous pouvez ajuster pour
+   configurer votre PHP selon l'hôte virtuel ou le chemin. Ces sections sont optionnelles.
+  </para>
+  <para>
+   Ces sections n'affectent pas directement PHP. Elles sont utilisées pour grouper
+   les autres directives de configuration du &php.ini; et pour les appliquer à un hôte
+   ou à un chemin particulier.
+  </para>
+  <para>
+   Ces sections ne sont utilisées qu'en mode CGI/FastCGI et elles ne peuvent
+   définir des <link linkend="ini.extension">extensions</link> et des
+   directives <link linkend="ini.zend-extension">zend_extension</link>.
+  </para>
+  <para>
+   <table>
+    <title>Sections</title>
+    <tgroup cols="3">
+     <thead>
+      <row>
+       <entry>Nom</entry>
+       <entry>Modifiable</entry>
+       <entry>Historique</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry><link linkend="ini.per-host">[HOST=]</link></entry>
+       <entry>PHP_INI_SYSTEM</entry>
+       <entry>&php.version.added; 5.3.0.</entry>
+      </row>
+      <row>
+       <entry><link linkend="ini.per-path">[PATH=]</link></entry>
+       <entry>PHP_INI_SYSTEM</entry>
+       <entry>&php.version.added; 5.3.0.</entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </table>
+  </para>
+  
+  &ini.descriptions.title;
+  
+  <para>
+   <variablelist>
+    <varlistentry xml:id="ini.per-host">
+     <term>
+      <parameter>[HOST=&lt;host&gt;]</parameter>
+     </term>
+     <listitem>
+      <para>
+       Cette section vous permet de définir un jeu de directives du &php.ini;
+       qui prendront effet sur l'hôte spécifié.
+      </para>
+      <para>
+       <example>
+        <title>Active la sortie d'erreur à l'écran pour dev.site.com</title>
+        <programlisting role="php.ini">
+<![CDATA[
+[HOST=dev.site.com]
+error_reporting = E_ALL
+display_errors = On
+]]>
+        </programlisting>
+       </example>
+      </para>
+     </listitem>
+    </varlistentry>
+    
+    <varlistentry xml:id="ini.per-path">
+     <term>
+      <parameter>[PATH=&lt;path&gt;]</parameter>
+     </term>
+     <listitem>
+      <para>
+       Cette section vous permet de définir un jeu de directives du &php.ini;
+       qui prendront effet quand un script sera lancé depuis le chemin spécifié.
+      </para>
+      <para>
+       <example>
+        <title>Ajoute un script de sécurité pour les zones protégées</title>
+        <programlisting role="php.ini">
+<![CDATA[
+[PATH=/home/site/public/secure]
+auto_prepend_file=security.php
+]]>
+        </programlisting>
+       </example>
+      </para>
+     </listitem>
+    </varlistentry>
+    
+   </variablelist>
+  </para>
+ </section>
+ 
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
--- a/appendices/ini.xml
+++ b/appendices/ini.xml
--- a/reference/curl/functions/curl-setopt.xml
+++ b/reference/curl/functions/curl-setopt.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: d2a9a020d63f7de94a2f803dcbc18c032828336f Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 4f2bd632710cf0a7def679d37de7809b744c0aef Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
@@ -188,6 +188,15 @@
           <entry valign="top">
           </entry>
          </row>
+          <row>
+           <entry valign="top"><constant>CURLOPT_FTP_CREATE_MISSING_DIRS</constant></entry>
+           <entry valign="top">
+            &true; pour créer les dossiers intermédiaires lorsqu'une opération FTP
+            est demandée sur un chemin qui n'existe pas.
+           </entry>
+           <entry valign="top">
+           </entry>
+          </row>
          <row>
           <entry valign="top"><constant>CURLOPT_FTPAPPEND</constant></entry>
           <entry valign="top">
--- a/reference/dom/domdocument/getelementsbytagname.xml
+++ b/reference/dom/domdocument/getelementsbytagname.xml
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: dams Status: ready -->
+<!-- EN-Revision: 2bb8f9439082f966e514d1aa33f28feae1062f24 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <refentry xml:id="domdocument.getelementsbytagname" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>DOMDocument::getElementsByTagName</refname>
-  <refpurpose>Cherche tous les éléments qui ont le nom de balise donné</refpurpose>
+  <refpurpose>Cherche tous les éléments qui ont le nom de la balise locale donné</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
@@ -16,7 +16,7 @@
  </methodsynopsis>
  <para>
   Cette fonction retourne une instance de la classe
-   <classname>DOMNodeList</classname> contenant les éléments
+   <classname>DOMNodeList</classname> contenant tous les éléments
   qui ont un nom de balise donné.
  </para>
 </refsect1>
@@ -28,7 +28,7 @@
     <term><parameter>name</parameter></term>
     <listitem>
      <para>
-       Le nom de la balise à chercher. La valeur spéciale <literal>*</literal>
+       Le nom local (sans espace de nommage) de la balise à chercher. La valeur spéciale <literal>*</literal>
       correspond à toutes les balises.
      </para>
     </listitem>
@@ -43,6 +43,43 @@
   tous les éléments correspondants.
  </para>
 </refsect1>
+ <refsect1 role="examples"><!-- {{{ -->
+  &reftitle.examples;
+  <para>
+   <example xml:id="domdocument.getelementsbytagname.example.basic"><!-- {{{ -->
+    <title>Exemple de base</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$xml = <<< XML
+<?xml version="1.0" encoding="utf-8"?>
+<books>
+ <book>Patterns of Enterprise Application Architecture</book>
+ <book>Design Patterns: Elements of Reusable Software Design</book>
+ <book>Clean Code</book>
+</books>
+XML;
+
+$dom = new DOMDocument;
+$dom->loadXML($xml);
+$books = $dom->getElementsByTagName('book');
+foreach ($books as $book) {
+    echo $book->nodeValue, PHP_EOL;
+}
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Patterns of Enterprise Application Architecture
+Design Patterns: Elements of Reusable Software Design
+Clean Code
+]]>
+    </screen>
+   </example><!-- }}} -->
+  </para>
+ </refsect1><!-- }}} -->
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
--- a/reference/mongo/ini.xml
+++ b/reference/mongo/ini.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c47a493278b919120a765ee01c79bd5088c9d339 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 065dd47a92e160002f184d194e8fad1fe0f0822c Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <section xml:id="mongo.configuration" xmlns="http://docbook.org/ns/docbook">
@@ -64,7 +64,7 @@
      <entry>PHP_INI_ALL</entry>
     </row>
     <row>
-      <entry><link linkend="ini.mongo.allow_empty_keys">mongo.allow_empty_keys</link></entry>
+      <entry><link linkend="ini.mongo.allow-empty-keys">mongo.allow_empty_keys</link></entry>
      <entry>false</entry>
      <entry>PHP_INI_ALL</entry>
     </row>
@@ -258,7 +258,7 @@ $query = array( "i" => array( ":gt" => 20, ":lte" => 30 ) );
    </listitem>
   </varlistentry>
   
-   <varlistentry xml:id="ini.mongo.allow_empty_keys">
+   <varlistentry xml:id="ini.mongo.allow-empty-keys">
    <term>
     <parameter>mongo.allow_empty_keys</parameter>
     <type>int</type>
--- a/reference/mongo/mongo.xml
+++ b/reference/mongo/mongo.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: d0146aabde81aaa681bdbf5c37ed5563f31df448 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 5e240161c187efd52d2b7a4b16c3213dea885ad7 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <phpdoc:classref xml:id="class.mongo" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -81,7 +81,7 @@ $db = $m->foo; // lecture de l'objet de base de données "foo"
    <fieldsynopsis>
     <modifier>public</modifier>
     <type>string</type>
-     <varname>status</varname>
+     <varname linkend="mongo.props.status">status</varname>
     <initializer>&null;</initializer>
    </fieldsynopsis>
    <fieldsynopsis>
@@ -142,10 +142,10 @@ $db = $m->foo; // lecture de l'objet de base de données "foo"
  </section>
  
  <section>
-   <title>Fields</title>
+   <title>Champs</title>
   <variablelist>
-    <varlistentry>
-     <term>status</term>
+    <varlistentry xml:id="mongo.props.status">
+     <term><varname>status</varname></term>
     <listitem>
      <simpara>
       Si c'est une connexion persistante, si la connexion a été créée pour cet objet
--- a/reference/mongo/mongocollection.xml
+++ b/reference/mongo/mongocollection.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f5b736e8520c06030e4a23bb9562c2ac60582d50 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 5e240161c187efd52d2b7a4b16c3213dea885ad7 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <phpdoc:classref xml:id="class.mongocollection" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -66,18 +66,18 @@
    <fieldsynopsis>
     <modifier>public</modifier>
     <type>MongoDB</type>
-     <varname>db</varname>
+     <varname linkend="mongocollection.props.db">db</varname>
     <initializer>&null;</initializer>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <type>integer</type>
-     <varname>w</varname>
+     <varname linkend="mongocollection.props.w">w</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <type>integer</type>
-     <varname>wtimeout</varname>
+     <varname linkend="mongocollection.props.wtimeout">wtimeout</varname>
    </fieldsynopsis>
    
    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
@@ -114,16 +114,16 @@
  <section>
   <title>Champs</title>
   <variablelist>
-    <varlistentry>
-     <term>db</term>
+    <varlistentry xml:id="mongocollection.props.db">
+     <term><varname>db</varname></term>
     <listitem>
      <para>
       La base de données "parente" pour cette collection.
      </para>
     </listitem>
    </varlistentry>
-    <varlistentry>
-     <term>w</term>
+    <varlistentry xml:id="mongocollection.props.w">
+     <term><varname>w</varname></term>
     <listitem>
      <para>
       Le nombre de serveurs vers lesquels répliquer un changement avant de retourner
@@ -133,8 +133,8 @@
      </para>
     </listitem>
    </varlistentry>
-    <varlistentry>
-     <term>wtimeout</term>
+    <varlistentry xml:id="mongocollection.props.wtimeout">
+     <term><varname>wtimeout</varname></term>
     <listitem>
      <para>
       Le nombre de millisecondes à attendre que les réplications
--- a/reference/mongo/mongocursor.xml
+++ b/reference/mongo/mongocursor.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 907fb5254ca0dc6028a851e515e563ab6392f7b4 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 5e240161c187efd52d2b7a4b16c3213dea885ad7 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <phpdoc:classref xml:id="class.mongocursor" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -123,13 +123,13 @@ $cursor->skip(4);
    <fieldsynopsis>
     <modifier>static</modifier>
     <type>boolean</type>
-     <varname>slaveOkay</varname>
+     <varname linkend="mongocursor.props.slaveokay">slaveOkay</varname>
     <initializer>&false;</initializer>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>static</modifier>
     <type>integer</type>
-     <varname>timeout</varname>
+     <varname linkend="mongocursor.props.timeout">timeout</varname>
     <initializer>20000</initializer>
    </fieldsynopsis>
    
@@ -144,8 +144,8 @@ $cursor->skip(4);
    <title>Variables statiques</title>

   <variablelist>
-    <varlistentry>
-     <term><property>MongoCursor::slaveOkay</property></term>
+    <varlistentry xml:id="mongocursor.props.slaveokay">
+     <term><varname>slaveOkay</varname></term>
     <listitem>
      <para>
       Est ce que la requête doit avoir le drapeau "slaveOkay" activé, ce qui permet
@@ -155,8 +155,8 @@ $cursor->skip(4);
      </para>
     </listitem>
    </varlistentry>
-    <varlistentry>
-     <term><property>MongoCursor::timeout</property></term>
+    <varlistentry xml:id="mongocursor.props.timeout">
+     <term><varname>timeout</varname></term>
     <listitem>
      <para>
       Affecte le timeout en millisecondes pour les réponses des bases de données. Pour
--- a/reference/mongo/mongodb.xml
+++ b/reference/mongo/mongodb.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4d4a1873d5428068902b70f3444ead98da488b78 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 5e240161c187efd52d2b7a4b16c3213dea885ad7 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <phpdoc:classref xml:id="class.mongodb" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -82,13 +82,13 @@ $db = $m->selectDB("exemple");
    <fieldsynopsis>
     <modifier>public</modifier>
     <type>integer</type>
-     <varname>w</varname>
+     <varname linkend="mongodb.props.w">w</varname>
     <initializer>1</initializer>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <type>integer</type>
-     <varname>wtimeout</varname>
+     <varname linkend="mongodb.props.wtimeout">wtimeout</varname>
     <initializer>10000</initializer>
    </fieldsynopsis>
    
@@ -139,8 +139,8 @@ $db = $m->selectDB("exemple");
  <section>
   <title>Champs</title>
   <variablelist>
-    <varlistentry>
-     <term>w</term>
+    <varlistentry xml:id="mongodb.props.w">
+     <term><varname>w</varname></term>
     <term>1</term>
     <listitem>
      <para>
@@ -173,8 +173,8 @@ $db = $m->selectDB("exemple");
      </para>
     </listitem>
    </varlistentry>
-    <varlistentry>
-     <term>wtimeout</term>
+    <varlistentry xml:id="mongodb.props.wtimeout">
+     <term><varname>wtimeout</varname></term>
     <term>10000</term>
     <listitem>
      <para>
--- a/reference/mongo/mongoexception.xml
+++ b/reference/mongo/mongoexception.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 576d9a8422b61668113a8065f0abc00849f458b2 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 065dd47a92e160002f184d194e8fad1fe0f0822c Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <phpdoc:classref xml:id="class.mongoexception" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -47,7 +47,7 @@
      Vous avez tenté de sauvegardé une clé "". Vous ne devriez pas agir comme cela. "" peut
      servir pour des sous-objets et est utilisé en interne par MongoDB. Cependant, si vous le
      voulez vraiment, vous pouvez placer
-      <link linkend="ini.mongo.allow_empty_keys">mongo.allow_empty_keys</link>
+      <link linkend="ini.mongo.allow-empty-keys">mongo.allow_empty_keys</link>
      à true dans php.ini pour surcharger cette vérification. Si tel est le cas, il est recommandé
      d'utiliser la vérification stricte des erreurs.
     </para>
--- a/reference/mongo/mongoid.xml
+++ b/reference/mongo/mongoid.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7214d04a66fb2e93d8156f8995b01b858e12e3f8 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 5e240161c187efd52d2b7a4b16c3213dea885ad7 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->

 <phpdoc:classref xml:id="class.mongoid" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -66,7 +66,7 @@ C:7:"MongoId":24:{4af9f23d8ead0e1d32000000}
    <fieldsynopsis>
     <modifier>public</modifier>
     <type>string</type>
-     <varname>$id</varname>
+     <varname linkend="mongoid.props.id">$id</varname>
     <initializer>&null;</initializer>
    </fieldsynopsis>
    
@@ -78,10 +78,10 @@ C:7:"MongoId":24:{4af9f23d8ead0e1d32000000}
  </section>

  <section>
-   <title>Fields</title>
+   <title>Champs</title>
   <variablelist>
-    <varlistentry>
-     <term>$id</term>
+    <varlistentry xml:id="mongoid.props.id">
+     <term><varname>$id</varname></term>
     <listitem>
      <simpara>
       Ce champ contient la représentation sous forme de chaine de cet objet.