Modified: phpdoc/fr/trunk/reference/array/functions/array-merge.xml
===================================================================
--- phpdoc/fr/trunk/reference/array/functions/array-merge.xml	2010-05-03 09:38:15 UTC (rev 298897)
+++ phpdoc/fr/trunk/reference/array/functions/array-merge.xml	2010-05-03 09:59:19 UTC (rev 298898)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 298804 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->

 <refentry xml:id="function.array-merge" xmlns="http://docbook.org/ns/docbook">
@@ -28,8 +28,9 @@
    les valeurs sont ajoutées en fin de tableau.
   </para>
   <para>
-   Si vous passez un seul tableau à cette fonction et qu'il a des index
-   numériques, les clés seront réindexées normalement.
+   Si tous les tableaux contiennent uniquement des clés numériques,
+   le tableau résultant contiendra des clés d'incrément, en commençant
+   par zéro.
   </para>
  </refsect1>


Modified: phpdoc/fr/trunk/reference/oci8/examples.xml
===================================================================
--- phpdoc/fr/trunk/reference/oci8/examples.xml	2010-05-03 09:38:15 UTC (rev 298897)
+++ phpdoc/fr/trunk/reference/oci8/examples.xml	2010-05-03 09:59:19 UTC (rev 298898)
@@ -1,106 +1,137 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 291049 Maintainer: yannick Status: ready -->
+<!-- Reviewed: no -->

 <chapter xml:id="oci8.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
- <section xml:id="oci8.examples-basic">
+ <para>
+  Ces exemples utilisent, pour se connecter à la base de données,
+  l'utilisateur <literal>HR</literal> qui est le schéma
+  <literal>&quot;Human Resources&quot;</literal> fourni par la
+  base de données Oracle. Ce compte doit avoir été déverrouillé et
+  le mot de passe réinitialisé avant de pouvoir l'utiliser.
+ </para>
+
+ <para>
+  Ces exemples se connectent à la base de données
+  <literal>XE</literal> de votre machine. Modifiez la chaîne de connection
+  afin de correspondre à votre base de données avant d'exécuter les
+  exemples de cette documentation.
+ </para>
+
+ <example>
+  <title>Requête simple</title>
   <para>
-   <example>
-    <title>Requête basique</title>
-     <programlisting role="php">
+   Cet exemple montre l'exécution d'une requête et l'affiche des résultats.
+   Les requêtes OCI8 utilisent les étapes préparation/exécution/récupération
+   des données.
+  </para>
+  <programlisting role="php">
 <![CDATA[
 <?php

-  $conn = oci_connect('hr', 'hr', 'orcl');
-  if (!$conn) {
+$conn = oci_connect('hr', 'welcome', 'localhost/XE');
+if (!$conn) {
     $e = oci_error();
-    print htmlentities($e['message']);
-    exit;
-  }
+    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
+}

-  $query = 'SELECT * FROM DEPARTMENTS';
-
-  $stid = oci_parse($conn, $query);
-  if (!$stid) {
+// Préparation de la requête
+$stid = oci_parse($conn, 'SELECT * FROM departments');
+if (!$stid) {
     $e = oci_error($conn);
-    print htmlentities($e['message']);
-    exit;
-  }
+    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
+}

-  $r = oci_execute($stid, OCI_DEFAULT);
-  if (!$r) {
+// Exécution de la logique de la requête
+$r = oci_execute($stid);
+if (!$r) {
     $e = oci_error($stid);
-    echo htmlentities($e['message']);
-    exit;
-  }
+    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
+}

-  print '<table border="1">';
-  while ($row = oci_fetch_array($stid, OCI_RETURN_NULLS)) {
-    print '<tr>';
-       foreach ($row as $item) {
-         print '<td>'.($item?htmlentities($item):'&nbsp;').'</td>';
-       }
-       print '</tr>';
-  }
-  print '</table>';
+// Récupération des résultats de la requête
+print "<table border='1'>\n";
+while ($row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_NULLS)) {
+    print "<tr>\n";
+    foreach ($row as $item) {
+        print "    <td>" . ($item !== null ? htmlentities($item, ENT_QUOTES) : "") . "</td>\n";
+    }
+    print "</tr>\n";
+}
+print "</table>\n";

-  oci_close($conn);
+oci_free_statement($stid);
+oci_close($conn);
+
 ?>
 ]]>
-     </programlisting>
-   </example>
+  </programlisting>
+ </example>
+
+ <example>
+  <title>Insertion de données en utilisant des variables liées</title>
+  <para>
+   Les variables liées augmentent les performances en permettant la réutilisation
+   du cache et du contexte d'exécution. Les variables liées augmentent également
+   la sécurité en prévenant bons nombres d'injection SQL.
   </para>
-  <para>
-   <example>
-    <title>Requête Insert avec des variables liées</title>
-     <programlisting role="php">
+  <programlisting role="php">
 <![CDATA[
 <?php

-  // Avant d'exécuter, création de la table
-  //   CREATE TABLE MYTABLE (mid NUMBER, myd VARCHAR2(20));
+// Avant l'exécution, créez la table suivante :
+//   CREATE TABLE MYTABLE (mid NUMBER, myd VARCHAR2(20));

-  $conn = oci_connect('scott', 'tiger', 'orcl');
+$conn = oci_connect('hr', 'welcome', 'localhost/XE');
+if (!$conn) {
+    $e = oci_error();
+    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
+}

-  $query = 'INSERT INTO MYTABLE VALUES(:myid, :mydata)';
+$stid = oci_parse($conn, 'INSERT INTO MYTABLE (mid, myd) VALUES(:myid, :mydata)');

-  $stid = oci_parse($conn, $query);
+$id = 60;
+$data = 'Some data';

-  $id = 60;
-  $data = 'Some data';
+oci_bind_by_name($stid, ':myid', $id);
+oci_bind_by_name($stid, ':mydata', $data);

-  oci_bind_by_name($stid, ':myid', $id);
-  oci_bind_by_name($stid, ':mydata', $data);
+$r = oci_execute($stid);  // exécution et validation

-  $r = oci_execute($stid);
+if ($r) {
+    print "Une ligne insérée";
+}

-  if ($r)
-    print "Une ligne a été insérée";
+oci_free_statement($stid);
+oci_close($conn);

-  oci_close($conn);
-
 ?>
 ]]>
-     </programlisting>
-   </example>
-  </para>
+  </programlisting>
+ </example>

-
+ <example>
+  <title>Insertion de données dans une colonne CLOB</title>
   <para>
-  <example>
-   <title>Insertion de donnée dans une colonne CLOB</title>
-    <programlisting role="php">
+   Pour de lourdes données, utilisez un objet binaire long (BLOB)
+   ou un objet de caractères long (CLOB). Cet exemple utilise les CLOB.
+  </para>
+  <programlisting role="php">
 <![CDATA[
 <?php

-// Avant l'exécution, création de la table
+// Avant l'exécution, créez la table suivante :
 //     CREATE TABLE MYTABLE (mykey NUMBER, myclob CLOB);

-$conn = oci_connect('scott', 'tiger', 'orcl');
+$conn = oci_connect('hr', 'welcome', 'localhost/XE');
+if (!$conn) {
+    $e = oci_error();
+    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
+}

-$mykey = 12343;  // clé arbitraire pour cet exemple;
+$mykey = 12343;  // clé arbitraire pour l'exemple

 $sql = "INSERT INTO mytable (mykey, myclob)
         VALUES (:mykey, EMPTY_CLOB())
@@ -110,58 +141,172 @@
 $clob = oci_new_descriptor($conn, OCI_D_LOB);
 oci_bind_by_name($stid, ":mykey", $mykey, 5);
 oci_bind_by_name($stid, ":myclob", $clob, -1, OCI_B_CLOB);
-oci_execute($stid, OCI_DEFAULT);
-$clob->save("A very long string");
+oci_execute($stid, OCI_NO_AUTO_COMMIT); // use OCI_DEFAULT for PHP <= 5.3.1
+$clob->save("Une chaîne vraiment très longue");

 oci_commit($conn);

-// Récupération des données CLOB
+// Récupération de données CLOB

 $query = 'SELECT myclob FROM mytable WHERE mykey = :mykey';

 $stid = oci_parse ($conn, $query);
 oci_bind_by_name($stid, ":mykey", $mykey, 5);
-oci_execute($stid, OCI_DEFAULT);
+oci_execute($stid);

 print '<table border="1">';
 while ($row = oci_fetch_array($stid, OCI_ASSOC)) {
-  $result = $row['MYCLOB']->load();
-  print '<tr><td>'.$result.'</td></tr>';
+    $result = $row['MYCLOB']->load();
+    print '<tr><td>'.$result.'</td></tr>';
 }
 print '</table>';

 ?>
 ]]>
-   </programlisting>
-  </example>
+  </programlisting>
+ </example>
+
+ <example>
+  <title>Utilisation d'une procédure stockée PL/SQL</title>
+  <para>
+   Vous devez lier une variable pour la valeur retournée et, optionnellement,
+   pour tous les arguments de la fonction PL/SQL.
   </para>
+  <programlisting role="php">
+<![CDATA[
+<?php
+
+/*
+  Avant d'exécuter le programme PHP, créez une fonction stockée
+  en langage SQL*Plus ou SQL Developer :
+
+  CREATE OR REPLACE FUNCTION myfunc(p IN NUMBER) RETURN NUMBER AS
+  BEGIN
+      RETURN p * 3;
+  END;
+
+*/
+
+$conn = oci_connect('hr', 'welcome', 'localhost/XE');
+if (!$conn) {
+    $e = oci_error();
+    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
+}
+
+$p = 8;
+
+$stid = oci_parse($conn, 'begin :r := myfunc(:p); end;');
+oci_bind_by_name($stid, ':p', $p);
+oci_bind_by_name($stid, ':r', $r, 40);
+
+oci_execute($stid);
+
+print "$r\n";   // Affiche 24
+
+oci_free_statement($stid);
+oci_close($conn);
+
+?>
+]]>
+  </programlisting>
+ </example>
+
+ <example>
+  <title>Utilisation d'une procédure stockée PL/SQL</title>
   <para>
-   Vous pouvez facilement accéder aux procédures stockées, de la même
-   façon que vous le feriez par ligne de commande :
-  <example>
-   <title>Utilisation de procédures stockées</title>
-    <programlisting role="php">
+   Avec les procédures stockées, vous devez lier les variables pour tous
+   les arguments.
+  </para>
+  <programlisting role="php">
 <![CDATA[
 <?php
-// par webmaster at remoterealty dot com
-$sth = oci_parse($dbh, "begin sp_newaddress( :address_id, '$firstname',
- '$lastname', '$company', '$address1', '$address2', '$city', '$state',
- '$postalcode', '$country', :error_code );end;");

-// Cela appelle la procédure stockée sp_newaddress, avec la variable :address_id
-// pour les entrées/sorties et :error_code comme variable de sortie.
-// Ensuite, vous faites les liaisons suivantes :
+/*
+  Avant d'exécuter le programme PHP, créez une procédure stockée en
+  langage SQL*Plus ou SQL Developer :

-   oci_bind_by_name($sth, ":address_id", $addr_id, 10);
-   oci_bind_by_name($sth, ":error_code", $errorcode, 10);
-   oci_execute($sth);
+  CREATE OR REPLACE PROCEDURE myproc(p1 IN NUMBER, p2 OUT NUMBER) AS
+  BEGIN
+      p2 := p1 * 2;
+  END;

+*/
+
+$conn = oci_connect('hr', 'welcome', 'localhost/XE');
+if (!$conn) {
+    $e = oci_error();
+    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
+}
+
+$p1 = 8;
+
+$stid = oci_parse($conn, 'begin myproc(:p1, :p2); end;');
+oci_bind_by_name($stid, ':p1', $p1);
+oci_bind_by_name($stid, ':p2', $p2, 40);
+
+oci_execute($stid);
+
+print "$p2\n";   // affiche 16
+
+oci_free_statement($stid);
+oci_close($conn);
+
 ?>
 ]]>
-    </programlisting>
-   </example>
+  </programlisting>
+ </example>
+
+ <example>
+  <title>Appel d'une fonction PL/SQL qui retourne un <literal>REF CURSOR</literal></title>
+  <para>
+   Chaque valeur retournée par la requête est un <literal>REF
+   CURSOR</literal> à utiliser pour récupérer les données.
   </para>
- </section>
+  <programlisting role="php">
+<![CDATA[
+<?php
+/*
+  Créez une fonction stockée PL/SQL comme ceci :
+
+  CREATE OR REPLACE FUNCTION myfunc(p1 IN NUMBER) RETURN SYS_REFCURSOR AS
+      rc SYS_REFCURSOR;
+  BEGIN
+      OPEN rc FOR SELECT city FROM locations WHERE ROWNUM < p1;
+      RETURN rc;
+  END;
+*/
+
+$conn = oci_connect('hr', 'welcome', 'localhost/XE');
+
+$stid = oci_parse($conn, 'SELECT myfunc(5) AS mfrc FROM dual');
+oci_execute($stid);
+
+echo "<table border='1'>\n";
+while (($row = oci_fetch_array($stid, OCI_ASSOC))) {
+    echo "<tr>\n";
+    $rc = $row['MFRC'];
+    oci_execute($rc);  // La valeur de la colonne retournée depuis la requête est une référence de curseur
+    while (($rc_row = oci_fetch_array($rc, OCI_ASSOC))) {
+        echo "    <td>" . $rc_row['CITY'] . "</td>\n";
+    }
+    oci_free_statement($rc);
+    echo "</tr>\n";
+}
+echo "</table>\n";
+
+// Affiche :
+//   Beijing
+//   Bern
+//   Bombay
+//   Geneva
+
+oci_free_statement($stid);
+oci_close($conn);
+
+?>
+]]>
+  </programlisting>
+ </example>
 </chapter>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/fr/trunk/reference/oci8/setup.xml
===================================================================
--- phpdoc/fr/trunk/reference/oci8/setup.xml	2010-05-03 09:38:15 UTC (rev 298897)
+++ phpdoc/fr/trunk/reference/oci8/setup.xml	2010-05-03 09:59:19 UTC (rev 298898)
@@ -1,144 +1,72 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 293322 Maintainer: yannick Status: ready -->
+<!-- Reviewed: no -->

 <chapter xml:id="oci8.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
-
+
  <!-- {{{ Requirements -->
  <section xml:id="oci8.requirements">
   &reftitle.required;
   <para>
-   Vous avez besoin des bibliothèques Oracles pour utiliser cette extension.
-   Les utilisateur Windows doivent utiliser les bibliothèques de version 10 ou supérieure pour
-   se servir de la bibliothèque <filename>php_oci8.dll</filename>.
+   L'extension OCI8 nécessite les bibliothèques clientes
+   9iR2, 10g ou 11g. Si la base de données Oracle est sur la même machine
+   que PHP, le logiciel de la base de données contient déjà toutes les
+   bibliothèques nécessaires. Lorsque PHP est sur une machine différente,
+   vous devez utilisez les bibliothèques libres
+   <link xlink:href="&url.oracle.instant.client;">Oracle Instant Client</link>.
   </para>
-  <note>
-   <para>
-    Cette extension ne supporte plus les bibliothèques Oracle 8 client.
-    Cependant, vous pouvez toujours vous connecter aux serveurs Oracle 8
-    tant que la bibliothèque client (v.9+) le supporte.
-   </para>
-  </note>
   <para>
-   La meilleure façon d'installer tous les fichiers nécessaires
-   est d'utiliser l'Instant Client Oracle, qui est disponible à l'adresse :
-   <link xlink:href="&url.oracle.instant.client;">&url.oracle.instant.client;</link>.
-   Pour fonctionner avec OCI8, le module OCI8 "basic" de l'Instant Client Oracle est
-   suffisant. L'Instant Client n'a pas besoin que les variables d'environnement
-   ORACLE_SID ou ORACLE_HOME soient définies. Par contre, vous devez toujours
-   définir les variables LD_LIBRARY_PATH et NLS_LANG.
+   Pour utiliser Oracle Instant Client, installez le fichier
+   compressé <literal>basic</literal> ou <literal>basiclite</literal> de
+   Oracle Instant Client  ou le paquet RPM. Lorsque vous compilez PHP depuis
+   ces sources, installez également le fichier compressé
+   <literal>sdk</literal> ou le paquet RPM <literal>devel</literal>.
   </para>
   <para>
-   Avant d'utiliser cette extension, assurez-vous que vous avez bien
-   paramétré vos variables d'environnement Oracle, ainsi que votre
-   démon utilisateur. Ces variables doivent être définies <emphasis>avant</emphasis>
-   de démarrer votre serveur web. Les variables dont vous pouvez avoir besoin sont :
-   <itemizedlist>
-    <listitem>
-     <simpara>
-      ORACLE_HOME
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      ORACLE_SID
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LD_PRELOAD
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LD_LIBRARY_PATH
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      NLS_LANG
-     </simpara>
-    </listitem>
-   </itemizedlist>
-   Pour les variables d'environnement Oracle moins fréquemment utilisées
-   comme TNS_ADMIN, TWO_TASK, ORA_TZFILE ainsi que les
-   diverses configurations globales Oracle comme les variables
-   ORA_NLS33, ORA_NLS10 et NLS_*, référez-vous à la documentation Oracle.
+   Sous Windows, OCI8 a besoin des bibliothèques clientes versions
+   10gR2 ou supérieur. Suivant la version du client Instant, vous pourriez
+   également avoir besoin des bibliothèques
+   <filename>mfc71.dll</filename> et <filename>msvcr71.dll</filename>.
   </para>
   <para>
-   Après avoir configuré ces variables pour votre utilisateur "serveur
-   web", assurez-vous aussi d'ajouter cet utilisateur (<literal>nobody</literal>,
-   <literal>www</literal>) au groupe Oracle.
+   Vous devriez exécuter PHP avec la même version (ou plus récente) des
+   bibliothèques Oracle utilisées pour compiler OCI8.
   </para>
   <note>
-   <title>
-    Si votre serveur web ne démarre pas ou plante au démarrage avec Oracle
-    </title>
    <para>
-    Vérifiez que Apache a bien été compilé avec la bibliothèque pthread :
+    Si OCI8 utilise les bibliothèques clientes 9iR2 ou 10g, alors PHP
+    peut se connecter aux bases de données Oracle 8i, 9iR2, 10g ou 11g.
+    Si OCI8 utilise les bibliothèques clientes 11g, la base de données
+    peut être 9iR2, 10g ou 11g.
    </para>
+  </note>
+  <note>
    <para>
-    <informalexample>
-     <screen>
-<![CDATA[
-# ldd /www/apache/bin/httpd
-   libpthread.so.0 => /lib/libpthread.so.0 (0x4001c000)
-   libm.so.6 => /lib/libm.so.6 (0x4002f000)
-   libcrypt.so.1 => /lib/libcrypt.so.1 (0x4004c000)
-   libdl.so.2 => /lib/libdl.so.2 (0x4007a000)
-   libc.so.6 => /lib/libc.so.6 (0x4007e000)
-   /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
-]]>
-     </screen>
-    </informalexample>
+    Le support de toutes les fonctionnalités OCI8 n'est disponible que
+    lors de l'utilisation des versions les plus récentes des bibliothèques
+    clientes mais aussi de la base de données la plus récente.
    </para>
-   <para>
-    Si la libpthread n'est pas listée, vous devez réinstaller Apache :
-   </para>
-   <para>
-    <informalexample>
-     <screen>
-<![CDATA[
-# cd /usr/src/apache_1.3.xx
-# make clean
-# LIBS=-lpthread ./config.status
-# make
-# make install
-]]>
-     </screen>
-    </informalexample>
-   </para>
-   <para>
-    Notez bien que sur certains systèmes comme UnixWare il faut utiliser
-    libthread au lieu de libpthread. PHP et Apache doivent alors être configurés
-    avec EXTRA_LIBS=-lthread.
-   </para>
   </note>
  </section>
  <!-- }}} -->
-
+
  <!-- {{{ Installation -->
- <section xml:id="oci8.installation">
-  &reftitle.install;
-  &no.install;
- </section>
+ &reference.oci8.configure;
  <!-- }}} -->
-
+
+ <!-- {{{ Testing -->
+ &reference.oci8.testing;
+ <!-- }}} -->
+
  <!-- {{{ Configuration -->
  &reference.oci8.ini;
  <!-- }}} -->
-
- <!-- {{{ Resources -->
- <section xml:id="oci8.resources">
-  &reftitle.resources;
-  &no.resource;
- </section>
- <!-- }}} -->
-
+
 </chapter>

+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml