PHP 8.4: Indicate extensions have been unbundledの翻訳 (#231)

* PHP 8.4: Indicate extensions have been unbundledの翻訳 php/doc-en#4103 * 改行を原文と併せる対応 --------- Co-authored-by: 武田憲太郎 <takeda@youmind.jp>
php · Dec 27, 2024 · d42b749 · d42b749
1 parent 8b18790
commit d42b749
Show file tree

Hide file tree

Showing 7 changed files with 126 additions and 76 deletions.
diff --git a/reference/imap/book.xml b/reference/imap/book.xml
@@ -1,16 +1,20 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 34892f82742329af7e7b4b22be6ad21418fd9768 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,mumumu -->
- 
+<!-- State: deprecated -->
 <book xml:id="book.imap" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="bundledexternal" ?>
+ <?phpdoc extension-membership="pecl" ?>
  <title>IMAP、POP3 および NNTP</title>
  <titleabbrev>IMAP</titleabbrev>
 
  <!-- {{{ preface -->
  <preface xml:id="intro.imap">
   &reftitle.intro;
+  <warning>
+   <simpara>
+    この拡張モジュールは、PHP 8.4.0 以降では<emphasis>非推奨</emphasis>となり、PHP にも<emphasis>バンドルされません</emphasis>。
+   </simpara>
+  </warning>
   <para>
    これらの関数は、<acronym>IMAP</acronym> プロトコルのほかに
    <acronym>NNTP</acronym> や <acronym>POP3</acronym>、
@@ -35,7 +39,6 @@
  &reference.imap.imap.connection;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/imap/configure.xml b/reference/imap/configure.xml
@@ -1,38 +1,51 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fc870e6f972ed48069f4c7a5a449c2e843f343a7 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: hirokawa Status: ready -->
 <!-- Credits: mumumu -->
-<section xml:id="imap.installation" xmlns="http://docbook.org/ns/docbook">
+<section xml:id="imap.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
- <para>
-  これらの関数を動作させるには、<option role="configure">--with-imap[=DIR]</option>
-  を指定して PHP をコンパイルする必要があります。DIR は c-client 
-  インストール時のプレフィックスです。上の例のような場合には
-  <option role="configure">--with-imap=/usr/local/imap-2000b</option>
-  を指定します。この場所は、上の指示にしたがってあなたが作成したディレクトリの
-  場所に依存します。<productname>Windows</productname> ユーザーは、&php.ini; で
-  <filename>php_imap.dll</filename> DLL を有効にします。
- </para>
- <note>
-  <simpara>
-   c-client の設定によっては、これ以外に
-   <option role="configure">--with-imap-ssl=/path/to/openssl/</option>
-   や <option role="configure">--with-kerberos=/path/to/kerberos</option>
-   といったオプションを PHP の configure で指定する必要があります。
-  </simpara>
- </note>
+ <section xml:id="imap.installation.php84">
+  <title>PHP 8.4</title>
+  <para>
+   &pecl.moved-ver;8.4.0
+  </para>
+  <para>
+   &pecl.info;
+   <link xlink:href="&url.pecl.package;imap">&url.pecl.package;imap</link>.
+  </para>
+ </section>
 
- <warning>
-  <simpara>
-    IMAP 拡張モジュールはスレッドセーフではありません。
-    よって、ZTS が有効なPHPで使うべきではありません。
-  </simpara>
- </warning>
+ <section xml:id="imap.installation.phplt84">
+  <title>PHP &lt; 8.4</title>
+  <para>
+   これらの関数を動作させるには、<option role="configure">--with-imap[=DIR]</option>
+   を指定して PHP をコンパイルする必要があります。DIR は c-client 
+   インストール時のプレフィックスです。上の例のような場合には
+   <option role="configure">--with-imap=/usr/local/imap-2000b</option>
+   を指定します。この場所は、上の指示にしたがってあなたが作成したディレクトリの
+   場所に依存します。<productname>Windows</productname> ユーザーは、&php.ini; で
+   <filename>php_imap.dll</filename> DLL を有効にします。
+  </para>
+  <note>
+   <simpara>
+    c-client の設定によっては、これ以外に
+    <option role="configure">--with-imap-ssl=/path/to/openssl/</option>
+    や <option role="configure">--with-kerberos=/path/to/kerberos</option>
+    といったオプションを PHP の configure で指定する必要があります。
+   </simpara>
+  </note>
 
- &warn.imaprecodeyaz;
+  <warning>
+   <simpara>
+     IMAP 拡張モジュールはスレッドセーフではありません。
+     よって、ZTS が有効なPHPで使うべきではありません。
+   </simpara>
+  </warning>
 
-</section>
+  &warn.imaprecodeyaz;
+ </section>
 
+</section>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/oci8/book.xml b/reference/oci8/book.xml
@@ -1,16 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b9e6268918813e27972c644897970b0cdbc6f86e Maintainer: satoruyoshida Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: satoruyoshida Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,takagi -->
 
 <book xml:id="book.oci8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="bundledexternal" ?>
+ <?phpdoc extension-membership="pecl" ?>
  <title>Oracle OCI8</title>
  <titleabbrev>OCI8</titleabbrev>
 
  <!-- {{{ preface -->
  <preface xml:id="intro.oci8">
   &reftitle.intro;
+  <warning>
+   <simpara>
+    この拡張モジュールは、PHP 8.4.0 以降では PHP に<emphasis>バンドルされません</emphasis>。
+   </simpara>
+  </warning>
   <para>
    これらの関数により、 Oracle データベースにアクセスできます。
    これらは SQL 及び PL/SQL 文をサポートします。基本的なフィーチャーには、

diff --git a/reference/pdo_oci/configure.xml b/reference/pdo_oci/configure.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 537e6eeb269cf03277df4c947fccf8e2a8d944bf Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <section xml:id="ref.pdo-oci.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
@@ -11,31 +11,45 @@
   フリーの <link xlink:href="&url.oracle.instant.client;">Oracle インスタントクライアント</link> ライブラリを使ってください。
   詳細は <link linkend="oci8.requirements">OCI8 のインストール要件</link> のセクションを参照ください。
  </para>
- <para>
-  <option role="configure">--with-pdo-oci[=DIR]</option> で
-  PDO Oracle OCI 拡張モジュールをインストールします。オプションの <literal>[=DIR]</literal>
-  には、Oracle のホームディレクトリを指定することができます。
-  <literal>[=DIR]</literal> のデフォルトは、環境変数
-  <varname>$ORACLE_HOME</varname> の値です。
- </para>
- <para>
-  <option role="configure">--with-pdo-oci=instantclient,prefix,version</option>
-  で、Oracle Instant Client <acronym>SDK</acronym> を指定します。prefix および
-  version は環境にあわせて設定します。
- </para>
- <para>
-  <screen>
-<![CDATA[
+
+ <section xml:id="pdo-oci.installation.php84">
+  <title>PHP 8.4</title>
+  <para>
+   &pecl.moved-ver;8.4.0
+  </para>
+  <para>
+   &pecl.info;
+   <link xlink:href="&url.pecl.package;PDO_OCI">&url.pecl.package;PDO_OCI</link>.
+  </para>
+ </section>
+
+ <section xml:id="pdo-oci.installation.phplt84">
+  <title>PHP &lt; 8.4</title>
+  <para>
+   <option role="configure">--with-pdo-oci[=DIR]</option> で
+   PDO Oracle OCI 拡張モジュールをインストールします。オプションの <literal>[=DIR]</literal>
+   には、Oracle のホームディレクトリを指定することができます。
+   <literal>[=DIR]</literal> のデフォルトは、環境変数
+   <varname>$ORACLE_HOME</varname> の値です。
+  </para>
+  <para>
+   <option role="configure">--with-pdo-oci=instantclient,prefix,version</option>
+   で、Oracle Instant Client <acronym>SDK</acronym> を指定します。prefix および
+   version は環境にあわせて設定します。
+  </para>
+  <para>
+   <screen>
+    <![CDATA[
 // $ORACLE_HOME を使う例
 $ ./configure --with-pdo-oci
 
 // OIC for Linux 10.2.0.3 の RPM を /usr プレフィックスで使う例
 $ ./configure --with-pdo-oci=instantclient,/usr,10.2.0.3
 ]]>
-  </screen>
- </para>
+   </screen>
+  </para>
+ </section>
 </section>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/pdo_oci/reference.xml b/reference/pdo_oci/reference.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: aa4ea6fd0a6f00adaceea6e2dc030c2508ce47ac Maintainer: shimooka Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: shimooka Status: ready -->
 
  <reference xml:id="ref.pdo-oci" xmlns="http://docbook.org/ns/docbook">
-  <?phpdoc extension-membership="bundledexternal" ?>
+  <?phpdoc extension-membership="pecl" ?>
   <title>Oracle 関数 (PDO_OCI)</title>
   <titleabbrev>Oracle (PDO)</titleabbrev>
   <partintro>

diff --git a/reference/pspell/book.xml b/reference/pspell/book.xml
@@ -1,30 +1,33 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 81b23db050ac0627b056585c16bfe95445ae174e Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
-
 <book xml:id="book.pspell" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="bundledexternal" ?>
+ <?phpdoc extension-membership="pecl" ?>
  <title>Pspell</title>
- 
+
  <!-- {{{ preface -->
  <preface xml:id="intro.pspell">
   &reftitle.intro;
+  <warning>
+   <simpara>
+    この拡張モジュールは、PHP 8.4.0 以降では<emphasis>非推奨</emphasis>となり、PHP にも<emphasis>バンドルされません</emphasis>。
+   </simpara>
+  </warning>
   <para>
    これらの関数により、単語のスペルチェックを行い、修正案を提案させる
    ことが可能となります。
   </para>
  </preface>
  <!-- }}} -->
- 
+
  &reference.pspell.setup;
  &reference.pspell.constants;
  &reference.pspell.reference;
  &reference.pspell.pspell.dictionary;
  &reference.pspell.pspell.config;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/pspell/configure.xml b/reference/pspell/configure.xml
@@ -1,27 +1,39 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b824e2b1086e94a1077bd071964547283616030a Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
-<section xml:id="pspell.installation" xmlns="http://docbook.org/ns/docbook">
+<section xml:id="pspell.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
- <para>
-  PHP をコンパイルする際に、オプション
-  <option role="configure">--with-pspell[=dir]</option> を追加する
-  必要があります。
- </para>
- <note>
-  <title>Win32 ユーザーへの注意</title>
+ <section xml:id="pspell.installation.php84">
+  <title>PHP 8.4</title>
   <para>
-   &ext.windows.path.dll;
-   aspell の <filename>bin</filename> フォルダにある
-   <filename>aspell-15.dll</filename>
+   &pecl.moved-ver;8.4.0
   </para>
   <para>
-   Win32 サポートは、aspell バージョン 0.50 以降が必要です。
+   &pecl.info;
+   <link xlink:href="&url.pecl.package;pspell">&url.pecl.package;pspell</link>.
   </para>
- </note>
-</section>
+ </section>
 
+ <section xml:id="pspell.installation.phplt84">
+  <title>PHP &lt; 8.4</title>
+  <para>
+   この拡張モジュールを有効にするには、<option role="configure">--with-pspell[=dir]</option>
+   オプションを指定して PHP をコンパイルします。
+  </para>
+  <note>
+   <title>Win32 ユーザーへの注意</title>
+   <para>
+    &ext.windows.path.dll;
+    aspell の <filename>bin</filename> フォルダにある
+    <filename>aspell-15.dll</filename>
+   </para>
+   <para>
+    Win32 サポートは、aspell バージョン 0.50 以降が必要です。
+   </para>
+  </note>
+ </section>
+</section>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml