svn: /phpdoc/ja/trunk/reference/oci8/ configure.xml connection.xml setup.xml

Modified: phpdoc/ja/trunk/reference/oci8/configure.xml
===================================================================
--- phpdoc/ja/trunk/reference/oci8/configure.xml	2020-11-27 00:37:00 UTC (rev 351688)
+++ phpdoc/ja/trunk/reference/oci8/configure.xml	2020-11-27 02:15:07 UTC (rev 351689)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 351562 Maintainer: satoruyoshida Status: working -->
+<!-- EN-Revision: 351562 Maintainer: satoruyoshida Status: ready -->
 <!-- CREDITS: hirokawa, shimooka, mumumu -->
 <section xml:id="oci8.installation">
  &reftitle.install;
@@ -7,7 +7,7 @@


 <section xml:id="oci8.configure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
-<title>OCI8 とともに PHP を構成</title>
+<title>OCI8 とともに PHP を構成する</title>
  <para>
   OCI8 を構成する前に前述の <link linkend="oci8.requirements">要件</link> 節に
   目を通してください。
@@ -75,20 +75,23 @@
     </para>
     <!-- to be translated -->
     <para>
-     When prompted, enter either the value of <literal>$ORACLE_HOME</literal>, or
-     <literal>instantclient,/path/to/instant/client/lib</literal>.
+     プロンプトが出たら、
+     <literal>$ORACLE_HOME</literal> または、
+     <literal>instantclient,/path/to/instant/client/lib</literal> を入力して下さい。
     </para>
     <para>
-     Note: Do not enter the text <literal>$ORACLE_HOME</literal>
-     because it will not be expanded.  Instead, enter the actual path
-     of the Oracle home directory.
+     注意: <literal>$ORACLE_HOME</literal> というテキストそのものを入力しないで下さい。
+     なぜなら展開されないからです。
+     代わりに、Oracle のホームディレクトリの実際のパスを入力するようにして下さい。
     </para>
    </listitem>
   </itemizedlist>
  </para>
  <para>
-  For a manual install when the <literal>pecl</literal> command is not
-  available, download the PECL OCI8 package, e.g. <filename>oci8-3.0.0.tgz</filename>.
+  <literal>pecl</literal> コマンドが利用できず、
+  手動インストールを行う場合、
+  PECL OCI8 のパッケージ、たとえば
+  <filename>oci8-3.0.0.tgz</filename> をダウンロードします。
  </para>
  <para>
   <itemizedlist>
@@ -165,8 +168,8 @@
   </itemizedlist>
  </para>
  <para>
-  After either an automatic or manual install, edit your &php.ini;
-  file and add the line:
+  自動、または手動インストールの後、&php.ini;
+  を編集し、次の行を追加します:
  </para>
  <para>
   <informalexample>
@@ -178,22 +181,22 @@
   </informalexample>
  </para>
  <para>
-  Make sure the &php.ini;
-  directive <link linkend="ini.extension-dir">extension_dir</link> is
-  set to the directory that <filename>oci8.so</filename> was installed
-  in.
+  <filename>oci8.so</filename> がインストールされたディレクトリが
+  &php.ini; の <link linkend="ini.extension-dir">extension_dir</link> に設定されていることを確認して下さい。
  </para>
 </section>
 <section>
- <title>Installing OCI8 as a Shared Extension</title>
+ <title>OCI8 を共有ライブラリとしてインストールする</title>
  <para>
-  If you are building PHP from source code, the
-  configuration <literal>shared</literal> option can be used to build OCI8 as a shared library
-  that can be dynamically loaded into PHP.  Building a shared extension allows
-  OCI8 to be upgraded easily without impacting the rest of PHP.
+  PHP をソースコードからビルドしている場合、
+  OCI8 を共有ライブラリとしてビルドするために
+  <literal>shared</literal> オプションが使えます。
+  これを使うと、PHP に動的にライブラリを読み込ませることが出来ます。
+  共有ライブありとしてビルドすると、
+  PHP の本体に影響を与えることなく、OCI8 をアップグレードできます。
  </para>
  <para>
-  Configure OCI8 using one of the following configure options.
+  以下のオプションを使って、OCI8 を設定できます。
  </para>
  <para>
   <itemizedlist>
@@ -214,13 +217,16 @@
      </informalexample>
     </para>
     <para>
-     If Instant Client 12.2 (or earlier) is installed from ZIP files, make sure to create
-     the library symbolic link first, for example <literal>ln -s
-     libclntsh.so.12.1 libclntsh.so</literal>.
+     Instant Client 12.2 (または前のバージョン)
+     が ZIP ファイルからインストールされている場合、
+     ライブラリへのシンボリックリンクが作られていることをまず確認して下さい。
+     たとえば
+     <literal>ln -s
+     libclntsh.so.12.1 libclntsh.so</literal> のようにします。
     </para>
     <para>
-     If using an RPM-based installation of Oracle Instant Client, the
-     configure line will look like this:
+     RPM を使って Oracle Instant Client をインストールしている場合、
+     configure コマンドは、以下のようになるでしょう:
     </para>
     <para>
      <informalexample>
@@ -232,18 +238,19 @@
      </informalexample>
     </para>
     <para>
-     For example, <option role="configure">--with-oci8=shared,instantclient,/usr/lib/oracle/19.9/client/lib</option>
+     <option role="configure">--with-oci8=shared,instantclient,/usr/lib/oracle/19.9/client/lib</option> のようにして、オプションを指定します。
     </para>
     <para>
-     Note that Oracle Instant Client support first appeared in PHP
-     4.3.11 and 5.0.4 and originally used the option
-     <option role="configure">--with-oci8-instant-client</option> to
-     configure PHP.
+     注意すべきなのは、PHP ではじめて
+     Oracle Instant Client がサポートされたのは PHP 4.3.11 と 5.0.4 で、
+     その時は <option role="configure">--with-oci8-instant-client</option>
+     というオプションが使われていたということです。
     </para>
    </listitem>
    <listitem>
     <para>
-     If using an Oracle database or full Oracle Client installation then do:
+     Oracle Database を使っているか、
+     Oracle Client が完全にインストールされている場合は、以下のようにします:
     </para>
     <para>
      <informalexample>
@@ -255,28 +262,31 @@
      </informalexample>
     </para>
     <para>
-     Make sure the web server user
-     (<literal>nobody</literal>, <literal>www</literal>) has access to
-     the libraries, initialization files
-     and <filename>tnsnames.ora</filename> (if used) under
-     the <literal>$ORACLE_HOME</literal> directory.  With Oracle
-     10<emphasis>g</emphasis>R2, you may need to run
-     the <filename>$ORACLE_HOME/install/changePerm.sh</filename>
-     utility to give directory access.
+     Webサーバのユーザ
+     (<literal>nobody</literal>, <literal>www</literal>)
+     が、ライブラリへのアクセス権を持っていることを確認して下さい。
+     <literal>$ORACLE_HOME</literal> 内にある初期化ファイルと
+     (もし使っていれば) <filename>tnsnames.ora</filename> です。
+     Oracle 10<emphasis>g</emphasis>R2 を使っている場合、
+     ディレクトリアクセスを与えるために
+     <filename>$ORACLE_HOME/install/changePerm.sh</filename>
+     を実行する必要があるかもしれません。
     </para>
    </listitem>
   </itemizedlist>
  </para>
  <para>
-  After configuration, follow the usual PHP building procedure,
-  e.g. <emphasis>make install</emphasis>.  The OCI8 shared extension
-  <filename>oci8.so</filename> library will be created.  It may need
-  to be manually moved to the PHP extension directory, specified by
-  the <link linkend="ini.extension-dir">extension_dir</link> option in
-  your &php.ini; file.
+  設定が終わった後は、いつもの PHP のビルドの手続きに従って下さい。
+  たとえば <emphasis>make install</emphasis> コマンドの実行です。
+  OCI8 の共有ライブラリ <filename>oci8.so</filename> が作成されます。
+  このファイルは、PHP の extension
+  ディレクトリに手動で移動する必要があるかもしれません。
+  このディレクトリは、&php.ini; の
+  <link linkend="ini.extension-dir">extension_dir</link> で指定します。
  </para>
  <para>
-  To complete installation of OCI8, edit &php.ini; and add the line:
+  OCI8 のインストールを完了するには、
+  &php.ini; を編集し、以下の一行を追加します。
  </para>
  <para>
   <informalexample>
@@ -289,16 +299,17 @@
  </para>
 </section>
 <section>
- <title>Installing OCI8 as a Statically Compiled Extension</title>
+ <title>OCI8 を静的リンクしてインストールする</title>
  <para>
-  If you are building PHP from source code, you can configure PHP to include
-  OCI8 as a static extension using one of the following configure options.
+  PHP をソースコードからビルドしている場合、
+  以下の configure オプションを使って、
+  OCI8 を静的ライブラリとして PHP に含めることが出来ます。
  </para>
  <para>
   <itemizedlist>
    <listitem>
     <para>
-     If using Oracle Instant Client, then do:
+     Oracle Instant Client を使っている場合、以下のようにします:
     </para>
     <para>
      <informalexample>
@@ -312,7 +323,8 @@
    </listitem>
    <listitem>
     <para>
-     If using an Oracle database or full Oracle Client installation then do:
+     Oracle Database を使っているか、
+     Oracle Client が完全にインストールされている場合は、以下のようにします:
     </para>
     <para>
      <informalexample>
@@ -327,23 +339,26 @@
   </itemizedlist>
  </para>
  <para>
-  After configuration, follow the usual PHP building procedure,
-  e.g. <emphasis>make install</emphasis>.  After successful
-  compilation, you do not need to add <filename>oci8.so</filename> to
-  &php.ini;.  No additional build steps are required.
+  設定が終わった後は、いつもの PHP のビルドの手続きに従って下さい。
+  たとえば <emphasis>make install</emphasis> コマンドの実行です。
+  コンパイルが終わった後は、
+  <filename>oci8.so</filename> を &php.ini; に追加する必要はありません。
+  追加のビルドステップも不要です。
  </para>
 </section>
 <section>
  <title>Windows で OCI8 をインストール</title>
  <para>
-  With Oracle 12<emphasis>c</emphasis> (or later) libraries, uncomment one of
-  the &php.ini; lines <literal>extension=php_oci8_12c.dll</literal>
-  or <literal>extension=php_oci8_11g.dll</literal>
-  or <literal>extension=php_oci8.dll</literal>. Only one of these DLLs may be
-  enabled at a time. DLLs with higher versions may contain more
-  functionality. Not all DLLs may be available for all versions of PHP.  Make
-  sure <link linkend="ini.extension-dir">extension_dir</link> is set to the
-  directory containing the PHP extension DLLs.
+  Oracle 12<emphasis>c</emphasis> (以降) のライブラリを使う場合、
+  &php.ini; の
+  <literal>extension=php_oci8_12c.dll</literal>,
+  <literal>extension=php_oci8_11g.dll</literal>,
+  <literal>extension=php_oci8.dll</literal> のいずれかをコメントアウトして下さい。
+  これらの DLL のうち、ひとつだけを1度に有効にできます。
+  バージョンが上のDLLには、より多くの機能が含まれています。
+  必ずしも全てのDLLが、全てのバージョンのPHPで利用できるとは限りません。
+  <link linkend="ini.extension-dir">extension_dir</link>
+  が、PHP の拡張機能の DLL を含んだディレクトリを指していることを確認して下さい。
  </para>
  <para>
   もし Instant Client を使用する場合、システムの <envar>PATH</envar>
@@ -411,18 +426,21 @@
      </row>
      <row>
       <entry>LD_LIBRARY_PATH</entry>
-      <entry>Set this (or its platform equivalent, such
-      as <literal>LIBPATH</literal>, or <literal>SHLIB_PATH</literal>) to the
-      location of the Oracle libraries, for
-      example <filename>$ORACLE_HOME/lib</filename>
-      or <filename>/usr/lib/oracle/18.5/client/lib</filename>. Note with Instant
-      Client 19 ZIP files on Linux it is more reliable to
-      use <filename>ldconfig</filename> instead, see the Instant Client
-      installation instructions.  With Instant Client 19 (or later) RPM
-      files, <literal>ldconfig</literal> is automatically run for you.  Some
-      users use
-      <literal>LD_PRELOAD</literal> instead
-      of <literal>LD_LIBRARY_PATH</literal>.</entry>
+      <entry>
+       この値(プラットフォームによっては、
+       <literal>LIBPATH</literal> や <literal>SHLIB_PATH</literal>
+       の場合があります) を Oracle ライブラリが入っている場所に設定します。
+       たとえば <filename>$ORACLE_HOME/lib</filename>
+       や <filename>/usr/lib/oracle/18.5/client/lib</filename> などです。
+       Linux 用の Instant Client 19 の ZIP ファイルについては、
+       <filename>ldconfig</filename> を代わりに使うことで、
+       さらに信頼性があがるよになっています。詳細は Instant Client の
+       インストール手順書を参照して下さい。
+       Instant Client 19 (またはそれ以降) の RPM ファイルでは、
+       <literal>ldconfig</literal> が自動で実行されるようになっています。
+       ユーザーによっては、<literal>LD_LIBRARY_PATH</literal> のかわりに
+       <literal>LD_PRELOAD</literal> を使うかもしれません。
+      </entry>
      </row>
      <row>
       <entry>NLS_LANG</entry>
@@ -435,15 +453,18 @@
      </row>
      <row>
       <entry>TNS_ADMIN</entry>
-      <entry>Contains the directory where the Oracle Net Services configuration
-      files such as <filename>tnsnames.ora</filename>
-      and <filename>sqlnet.ora</filename> are kept.  Not needed if
-      the <function>oci_connect</function> connection string uses the Easy
-      Connect naming syntax such as <literal>localhost/XE</literal>.  Not needed
-      if the network configuration files are in one of the default locations
-      such
-      as <filename>/usr/lib/oracle/VERSION/client/lib/network/admin</filename>, <filename>$ORACLE_HOME/network/admin</filename>
-      or <filename>/etc</filename>.
+      <entry>
+      <filename>tnsnames.ora</filename> や
+      <filename>sqlnet.ora</filename> のような
+      Oracle Net Service の設定ファイルが置かれたディレクトリを指定します。
+      <function>oci_connect</function> に指定する接続文字列が、
+      <literal>localhost/XE</literal> のような
+      簡易接続の名前付けの文法を使っている場合、この設定は不要です。
+      また、ネットワーク設定ファイルがデフォルトの位置に置かれている場合も不要です。
+      たとえば、
+      <filename>/usr/lib/oracle/VERSION/client/lib/network/admin</filename>,
+      <filename>$ORACLE_HOME/network/admin</filename>,
+      または <filename>/etc</filename> に置かれている場合です。
       </entry>
      </row>
     </tbody>

Modified: phpdoc/ja/trunk/reference/oci8/connection.xml
===================================================================
--- phpdoc/ja/trunk/reference/oci8/connection.xml	2020-11-27 00:37:00 UTC (rev 351688)
+++ phpdoc/ja/trunk/reference/oci8/connection.xml	2020-11-27 02:15:07 UTC (rev 351689)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 351562 Maintainer: satoruyoshida Status: working -->
+<!-- EN-Revision: 351562 Maintainer: satoruyoshida Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,takagi,mumumu -->
 <chapter xml:id="oci8.connection" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>OCI8 接続のハンドリングおよびプーリング</title>
@@ -70,26 +70,27 @@
    高トラフィックな Web アプリケーションに対しては
    <function>oci_new_connect</function> の使用を避けてください。
   </para>
-  <!-- to be translated -->
   <para>
-   From OCI8 1.3, persistent connections can be
-   closed by the user, allowing greater control over connection
-   resource usage.  Persistent connections will now also be closed
-   automatically when there is no PHP variable referencing them, such
-   as at the end of scope of a PHP user function.  This will rollback
-   any uncommitted transaction.  These changes to persistent
-   connections make them behave similarly to non-persistent
-   connections, simplifying the interface, allowing for greater
-   application consistency and predictability.
-   Use <link linkend="ini.oci8.old-oci-close-semantics">oci8.old_oci_close_semantics</link>
-   set to
-   <emphasis>On</emphasis> to retain the historical behavior.
+   OCI8 1.3 から、
+   持続的接続をユーザーが閉じられるようになりました。
+   これにより、接続リソースの使い方をユーザーがより強く制御できます。
+   持続的接続は、PHP の変数が参照していない場合にも、
+   自動的に閉じられるようになっています。
+   たとえば、PHP のユーザ関数のスコープの最後に到達した場合です。
+   これによって、コミットされていないトランザクションは全てロールバックされます。
+   持続的接続に対するこれらの変更によって、
+   持続的接続でない、通常の接続と似たような振る舞いをするようになります。
+   さらに、インターフェイスがシンプルになり、
+   アプリケーションの一貫性と予測可能性が改善されます。
+   歴史的な振る舞いを維持するには、
+   <link linkend="ini.oci8.old-oci-close-semantics">oci8.old_oci_close_semantics</link> の設定を <emphasis>On</emphasis> にして下さい。
   </para>
   <para>
-   The automatic re-establishment of PHP persistent connections after an Apache
-   or FPM process respawns means Oracle Database <literal>LOGON</literal>
-   triggers are only recommended for setting session attributes and not for
-   per-application user connection requests.
+   Apache や FPM のプロセスが再度 fork した後、
+   PHP の持続的接続は再接続されます。
+   これは、Oracle　Database の <literal>LOGON</literal> トリガに
+   セッション属性を設定するべきであり、
+   アプリケーションのユーザー接続単位で設定すべきではないということです。
   </para>
  </section>
  <section>

Modified: phpdoc/ja/trunk/reference/oci8/setup.xml
===================================================================
--- phpdoc/ja/trunk/reference/oci8/setup.xml	2020-11-27 00:37:00 UTC (rev 351688)
+++ phpdoc/ja/trunk/reference/oci8/setup.xml	2020-11-27 02:15:07 UTC (rev 351689)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 351562 Maintainer: satoruyoshida Status: working -->
+<!-- EN-Revision: 351562 Maintainer: satoruyoshida Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,takagi -->

 <chapter xml:id="oci8.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,20 +11,23 @@
   &reftitle.required;
   <para>
    <!-- to be translated -->
-   OCI8 3.0 is included with PHP 8. It is also available
-   from <link xmlns="http://docbook.org/ns/docbook"
+   OCI8 3.0 が PHP 8 には含まれています。
+   <link xmlns="http://docbook.org/ns/docbook"
    xmlns:xlink="http://www.w3.org/1999/xlink"
-   xlink:href="&url.pecl;">PECL</link>.  For PHP 7, use OCI8 2.2
-   from <link xmlns="http://docbook.org/ns/docbook"
+   xlink:href="&url.pecl;">PECL</link> からも利用できます
+   PHP 7 については、OCI8 2.2 が
+   <link xmlns="http://docbook.org/ns/docbook"
    xmlns:xlink="http://www.w3.org/1999/xlink"
-   xlink:href="&url.pecl;">PECL</link>.  OCI8 requires Oracle
-   10<emphasis>g</emphasis> or later Oracle client libraries.
+   xlink:href="&url.pecl;">PECL</link> から利用できます。
+   OCI8 は、Oracle
+   10<emphasis>g</emphasis> 以降のクライアントライブラリが必要です。
   </para>
   <para>
-   If the Oracle Database is on the same machine as PHP, the database software
-   already contains the necessary libraries and header files.  When PHP is on a
-   different machine, use the free
-   <link xlink:href="&url.oracle.instant.client;">Oracle Instant Client</link> libraries.
+   Oracle Database が PHP と同じマシンにある場合、
+   データベースのソフトウェアには必要なライブラリとヘッダファイルが含まれています。
+   PHP が違うマシンにある場合、
+   無料の <link xlink:href="&url.oracle.instant.client;">
+   ライブラリを使って下さい。
   </para>
   <para>
    Oracle Database と PHP が同じマシンで動いている場合は、必要なライブラリはデータベースソフトウェアの中にすべて含まれています。
@@ -44,12 +47,15 @@
   <note>
    <para>
     <!-- to be translated -->
-    Oracle's standard client-server network interoperability allows connections
-    between different versions of Oracle Client and Oracle Database.  For
-    certified configurations see Oracle Support's Doc ID 207303.1.  In
-    summary, Oracle Client 19, 18 and 12.2 can connect to Oracle Database 11.2
-    or greater. Oracle Client 12.1 can connect to Oracle Database 10.2 or
-    greater. Oracle Client 11.2 can connect to Oracle Database 9.2 or greater.
+    Oracle の標準のクライアント-サーバの
+    ネットワークの相互運用性によって、
+    Oracle のクライアントとデータベースのバージョンが違っていても
+    接続することが出来ます。
+    Oracle の正式なサポート文書 ID 207303.1.を要約すると、
+    Oracle Client 19, 18 と 12.2 は、
+    Oracle Database 11.2 以降にも接続できるとのことです。
+    Oracle Client 12.1 は Oracle Database 10.2 以降に接続できます。
+    Oracle Client 11.2 は Oracle Database 9.2 以降に接続できます。
    </para>
   </note>
   <note>