com doc/fr: Update and sync part of the OCI8 meta documents: reference/oci8/connection.xml reference/oci8/setup.xml
[email protected] (George Peter Banyard) Wed, 03 Mar 2021 17:31:41 +0000
| Newsgroups | php.doc.fr |
|---|---|
| Message-ID | <[email protected]> |
Commit: b9844c0f9dbe31a7908d1dc8d83949b45c12ec01 Author: George Peter Banyard <[email protected]> Wed, 3 Mar 2021 17:31:41 +0000 Parents: eae68376ae1ef2f366368bf2e4e7a989b2d63227 Branches: master Link: http://git.php.net/?p=doc/fr.git;a=commitdiff;h=b9844c0f9dbe31a7908d1dc8d83949b45c12ec01 Log: Update and sync part of the OCI8 meta documents Changed paths: M reference/oci8/connection.xml M reference/oci8/setup.xml
diff_b9844c0f9dbe31a7908d1dc8d83949b45c12ec01.txt
(text/plain, 14 KB)
diff --git a/reference/oci8/connection.xml b/reference/oci8/connection.xml
index e8e4946525..5da2c7f47f 100644
--- a/reference/oci8/connection.xml
+++ b/reference/oci8/connection.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 05699686607d6714c532dafac4e19de932cb7c63 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 5fcbcd6b56477034278a2199a8819635f3a0d9b9 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="oci8.connection" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -23,7 +23,7 @@
</para>
<para>
Si votre application se connecte à Oracle en utilisant un jeu différent de droits
- pour chaque utilisateur web, le cache persistant utilisé
+ de base de données pour chaque utilisateur web, le cache persistant utilisé
par la fonction <function>oci_pconnect</function> devient moins approprié
car l'augmentation du nombre d'utilisateurs concurrents va affecter les performances
de votre serveur Oracle, car il devra maintenir trop de connexions en cache.
@@ -58,7 +58,7 @@
Le cache de la fonction <function>oci_pconnect</function> est effacé
et toutes les connexions à la base de données sont closes lorsque le processus
PHP se termine, aussi, les connexions persistantes n'ont d'intérêts que lors
- de l'utilisation de PHP comme module Apache ou utilisé avec FCGI ou similaire.
+ de l'utilisation de PHP comme module Apache ou utilisé avec FPM ou similaire.
Les connexions persistantes n'ont aucun intérêts via <function>oci_connect</function>
lorsque PHP est utilisé comme CGI ou en ligne de commande.
</para>
@@ -69,6 +69,26 @@
<function>oci_new_connect</function>, particulièrement dans les sections
les plus chargées de l'application.
</para>
+ <para>
+ Depuis OCI8 1.3, les connexions persistantes peuvent désormais être fermées
+ par l'utilisateur, permettant ainsi un meilleur contrôle des ressources
+ de connexion. Les connexions persistantes peuvent maintenant être fermées
+ automatiquement lorsqu'aucune variable PHP ne les références, comme ce
+ pourrait être le cas à la fin d'un contexte d'une fonction utilisateur PHP.
+ Ceci annulera toutes les transactions non validées. Ces changements dans les
+ connexions persistantes font qu'elles fonctionnent comme les fonctions
+ non-persistantes, simplifiant l'interface, permettant une plus grande
+ cohérence de l'application et de prévisibilité. Définissez la directive
+ <link linkend="ini.oci8.old-oci-close-semantics">oci8.old_oci_close_semantics</link>
+ à <emphasis>On</emphasis> pour retrouver le comportement historique.
+ </para>
+ <para>
+ Le ré-établissement automatique des connexions persistantes PHP
+ après le redémarrage d'un processus Apache ou FPM fait que les triggers
+ <literal>LOGON</literal> sont uniquement recommandés pour définir
+ les attributs de session et non les requêtes de connexions utilisateurs
+ par application.
+ </para>
</section>
<section>
<title>Pool de connexion DRCP</title>
@@ -104,9 +124,8 @@
contient plusieurs informations internes sur DRCP.
</para>
<para>
- Pour utiliser DRCP, vous devez construire PHP avec l'extension
- OCI8 1.3 (ou supérieur) et les bibliothèques Oracle 11g (ou supérieur),
- puis, suivre ces étapes :
+ Pour utiliser DRCP, installez l'extension OCI8 1.3 (ou ultérieur) et les
+ bibliothèques Oracle 11g (ou ultérieur), puis, suivre ces étapes :
</para>
<para>
<itemizedlist>
@@ -207,108 +226,20 @@
</para>
<note>
<para>
- Les applications utilisant Oracle 10g qui ont besoin de la performance
+ Les applications utilisant Oracle Client libraries 10g qui ont besoin de la performance
des connexions persistantes, peuvent réduire la quantité de mémoire
allouée au serveur de la base de données en utilisant les serveurs
partagés Oracle (connu auparavant comme serveurs multi-threadés).
Reportez-vous à la documentation Oracle pour plus d'informations.
</para>
</note>
- </section>
- <section>
- <title>Recommandatation DRCP et limites connues</title>
- <para>
- La modification d'un mot de passe lors de connexions DRCP échouera
- avec l'erreur "<emphasis>ORA-56609: Usage not supported with DRCP</emphasis>".
- Ceci est une restriction documentée de la base de données Oracle 11g.
- </para>
- <para>
- Depuis OCI8 1.3, les connexions persistantes peuvent désormais être fermées
- par l'utilisateur, permettant ainsi un meilleur contrôle des ressources
- de connexion. Les connexions persistantes peuvent maintenant être fermées
- automatiquement lorsqu'aucune variable PHP ne les références, comme ce
- pourrait être le cas à la fin d'un contexte d'une fonction utilisateur PHP.
- Ceci annulera toutes les transactions non validées. Ces changements dans les
- connexions persistantes font qu'elles fonctionnent comme les fonctions
- non-persistantes, simplifiant l'interface, permettant une plus grande
- cohérence de l'application et de prévisibilité. Définissez la directive
- <link linkend="ini.oci8.old-oci-close-semantics">oci8.old_oci_close_semantics</link>
- à <emphasis>On</emphasis> pour retrouver l'ancien comportement.
- </para>
- <para>
- Si la base de données Oracle est à la version 11.1.0.6, le patch
- 6474441 doit être appliqué à la base de données afin de pouvoir utiliser
- DRCP. Sans ce patch, les erreurs comme <emphasis>ORA-01000: maximum
- open cursors exceeded</emphasis>, <emphasis>ORA-01001 invalid
- cursor</emphasis> ou <emphasis>ORA-01002 fetch out of
- sequence</emphasis> peuvent survenir. Ce bogue a été corrigé à partir des
- versions 11.1.0.7.
- </para>
- <para>
- Si ce patch ne peut être appliqué à votre base de données Oracle
- version 11.1.0.6, voici 3 façons de contourner ces problèmes :
- </para>
- <para>
- <itemizedlist>
- <listitem>
- <simpara>
- Connexion en utilisant des serveurs dédiés ou partagés
- au lieu d'utiliser DRCP.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Définir la directive PHP
- <link linkend="ini.oci8.statement-cache-size">oci8.statement_cache_size</link>
- à 0.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Définir un événement dans le fichier des paramètres d'initialisation
- à la base de données :
- <emphasis>event="56699 trace name context forever, level 128"</emphasis>.
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- Les bases de données Oracle 11.1.0.7 et 11.1.0.6 patché pour le bogue
- 6474441 permettent aux applications PHP utilisant les connexions DRCP
- d'utiliser un trigger <literal>LOGON</literal> pour définir les propriétés
- de session au moment de la création de la session, comme définir la langue
- ou le format de la date.
- </para>
- <para>
- Si le patch à la base de données 11.1.0.6 n'a pu être appliqué,
- un des contournements suivants peut être utilisé à la place des triggers
- <literal>LOGON</literal> :
- </para>
- <para>
- <itemizedlist>
- <listitem>
- <simpara>
- Après l'authentification, définissez explicitement les propriétés
- de session en utilisant du code PHP dans votre application.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Connexion en utilisant des serveurs dédiés ou partagés à la
- place de DRCP.
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- Le ré-établissement automatique des connexions persistantes PHP
- après une rupture des processus Apache ou FCGI fait que les triggers
- <literal>LOGON</literal> en PHP ne sont recommandés que pour définir
- les attributs de session et non les requêtes de connexions utilisateurs
- par applications. Ceci est d'autant plus vrai avec DRCP vu la
- taille automatique du pool ainsi que la façon dont les triggers
- <literal>LOGON</literal> sont émis avec l'authentification DRCP.
- </para>
+ <note>
+ <para>
+ La modification d'un mot de passe lors de connexions DRCP échouera
+ avec l'erreur "<emphasis>ORA-56609: Usage not supported with DRCP</emphasis>".
+ Ceci est une restriction documentée de la base de données Oracle 11g.
+ </para>
+ </note>
</section>
</chapter>
diff --git a/reference/oci8/setup.xml b/reference/oci8/setup.xml
index 5bc5a7c040..f247a6d9df 100644
--- a/reference/oci8/setup.xml
+++ b/reference/oci8/setup.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: cd110607fd94ccea0f99a693be555a50ce5c6b1e Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes Maintainer: mikaelkael -->
+<!-- EN-Revision: 5fcbcd6b56477034278a2199a8819635f3a0d9b9 Maintainer: girgias Status: ready -->
+<!-- Reviewed: no Maintainer: mikaelkael -->
<chapter xml:id="oci8.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -10,61 +10,39 @@
<section xml:id="oci8.requirements">
&reftitle.required;
<para>
- L'extension OCI8 1.4 est incluse avec PHP 5.3, PHP 5.4 et PHP
- 5.5. Elle est également disponible depuis
+ OCI8 3.0 est incluse avec PHP 8. Elle est également disponible depuis
<link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
- xlink:href="&url.pecl;">PECL</link>. Une version OCI8 2.0 plus récente
- est disponible uniquement depuis <link xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink"
- xlink:href="&url.pecl;">PECL</link>. OCI8 1.4 requiert les bibliothèques clientes Oracle
- 12<emphasis>c</emphasis>, 11<emphasis>g</emphasis>,
- 10<emphasis>g</emphasis> ou 9<emphasis>i</emphasis>R2 et peut s'installer
- sur PHP 4.3.9 et suivants. OCI8 2.0 requiert les bibliothèques clientes
- Oracle 12<emphasis>c</emphasis>, 11<emphasis>g</emphasis> ou
- 10<emphasis>g</emphasis> et peut s'installer sur PHP
- 5.2 et suivants.
+ xlink:href="&url.pecl;">PECL</link>. Pour PHP 7, utilisez OCI8 2.2 depuis
+ <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+ xlink:href="&url.pecl;">PECL</link>. OCI8 requiert Oracle 10<emphasis>g</emphasis>
+ ou bibliothèques cliente ultérieures.
</para>
<para>
- Si la base de données Oracle est sur la même machine que PHP, le
- logiciel de base de données contient déjà les bibliothèques nécessaires. Lorsque
- PHP est sur une machine différente, utilisez les bibliothèques gratuites
+ Si la base de données Oracle est sur la même machine que PHP, le logiciel
+ de base de données contient déjà les bibliothèques et en-têtes nécessaires.
+ Lorsque PHP est sur une machine différente, utilisez les bibliothèques gratuites
<link xlink:href="&url.oracle.instant.client;">Oracle Instant Client</link>.
</para>
<para>
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>.
+ compressé ZIP <literal>Basic</literal> ou <literal>Basic Light</literal> de
+ Oracle Instant Client, le paquet RPM, ou le paquet DMG.
+ Lors de la compilation de OCI8 depuis le code source, installez aussi le
+ <literal>SDK</literal> de Instant Client.
</para>
<para>
Vous devez exécuter PHP avec la même version ou une version plus récente des
bibliothèques clients Oracle utilisées pour construire OCI8.
</para>
- <para>
- Sous Windows, la bibliothèque DLL php_oci8 requiert les bibliothèques clientes
- depuis la version 10<emphasis>g</emphasis>R2 ou supérieure. En PHP 5.3, incluant PHP 5.3.5,
- la bibliothèque DLL php_oci8_11g requiert les bibliothèques clientes Oracle 11gR1
- ou supérieur. A partir de PHP 5.3.6, la bibliothèque DLL php_oci8_11g requiert les
- bibliothèques clientes Oracle 11<emphasis>g</emphasis>R2 ou supérieur. Depuis PHP
- 5.3.6, la bibliothèque DLL php_oci8_11g requiert les bibliothèques clientes Oracle
- 11<emphasis>g</emphasis>R2 ou supérieures. La bibliothèque DLL php_oci8_12c depuis
- PECL requiert les bibliothèques clientes Oracle 12<emphasis>c</emphasis>R1.
- Suivant la version du client Instant, vous pourriez également avoir besoin des bibliothèques
- <filename>mfc71.dll</filename> et <filename>msvcr71.dll</filename>.
- </para>
<note>
<para>
- Si OCI8 utilise les bibliothèques clientes 9<emphasis>i</emphasis>R2, alors PHP
- peut se connecter aux bases de données Oracle 8<emphasis>i</emphasis>, 9<emphasis>i</emphasis>R2,
- 10<emphasis>g</emphasis> ou 11<emphasis>g</emphasis>. Si OCI8 utilise les bibliothèques
- clientes 10<emphasis>g</emphasis>R2, la base de données peut être
- 9<emphasis>i</emphasis>R2, 10<emphasis>g</emphasis>, 11<emphasis>g</emphasis> ou
- 12<emphasis>c</emphasis>. Si OCI8 utilise les bibliothèques clientes 11<emphasis>g</emphasis>,
- la base de données peut être 9<emphasis>i</emphasis>R2,
- 10<emphasis>g</emphasis>, 11<emphasis>g</emphasis> ou 12<emphasis>c</emphasis>. Si OCI8 utilise
- les bibliothèques clientes 12<emphasis>c</emphasis>, la base de données peut être
- 10<emphasis>g</emphasis>R2, 11<emphasis>g</emphasis> ou 12<emphasis>c</emphasis>.
+ L'interopérabilité standard du réseau client-serveur d'Oracle permet des
+ connexions entre différentes versions de Oracle Client et Oracle Database.
+ Pour des configurations certifiées voir la documentation Oracle Support
+ ID ID 207303.1. En résumé, Oracle Client 19, 18 et 12.2 peuvent se
+ connecter à Oracle Database 10.2 ou supérieur. Oracle Client 12.1 peut se
+ connecter à Oracle Database 10.2 ou supérieur. Oracle Client 11.2 peut se
+ connecter à Oracle Database 9.2 ou supérieur.
</para>
</note>
<note>