PHP 8.5 の新機能を翻訳し、サンプル出力の不整合修正などを同期

language/oop5/inheritance.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: takagi Status: ready -->
+<!-- EN-Revision: df78bd1d232f2cd8df673accf5ba0e280695639b Maintainer: takagi Status: ready -->
  <sect1 xml:id="language.oop5.inheritance" xmlns="http://docbook.org/ns/docbook">
   <title>オブジェクトの継承</title>
   <para>
@@ -111,9 +111,9 @@ class Bar extends Foo
 $foo = new Foo();
 $bar = new Bar();
 $foo->printItem('baz'); // 出力: 'Foo: baz'
-$foo->printPHP();       // 出力: 'PHP is great' 
+$foo->printPHP();       // 出力: 'PHP is great.'
 $bar->printItem('baz'); // 出力: 'Bar: baz'
-$bar->printPHP();       // 出力: 'PHP is great'
+$bar->printPHP();       // 出力: 'PHP is great.'
 
 ?>
 ]]>

language/predefined/attributes/returntypewillchange.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 0019a7e201442447fd746c2852d28ba839ed15ae Maintainer: mumumu Status: ready -->
 <reference xml:id="class.returntypewillchange" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>ReturnTypeWillChange アトリビュート</title>
  <titleabbrev>ReturnTypeWillChange</titleabbrev>
@@ -9,17 +9,32 @@
 
   <section xml:id="returntypewillchange.intro">
    &reftitle.intro;
-   <para>
+   <simpara>
     ほとんどの final でない内部メソッドは、
     それをオーバライドする際、
     互換性がある戻り値の型を宣言することが必須になっています。
     そうしない場合、継承が有効かを検証する際に、
     推奨されない警告が発生します。
+    これは、暫定的な戻り値の型のフェーズを導入するものです。
+    つまり、戻り値の型に互換性がない場合、将来のバージョンでそれが強制されるまでは、
+    エンジンは致命的なエラーではなく、推奨されない警告を発生させます。
     PHP のバージョン間の互換性を保ちたいがために、
     戻り値の型を宣言できない場合、
     アトリビュート <code>#[\ReturnTypeWillChange]</code>
     を追加することで警告を抑止できます。
-   </para>
+   </simpara>
+
+   <warning>
+    <simpara>
+     <classname>ReturnTypeWillChange</classname> アトリビュートが推奨されない警告を抑止するのは、
+     暫定的な戻り値の型のフェーズの間<emphasis>だけ</emphasis>です。
+     ユーザー定義のクラスで定義されたメソッドをオーバーライドする場合には、何の効果もありません。
+     内部メソッドが strict な型を採用すると、
+     オーバーライドするメソッドのシグネチャの不一致は致命的なエラーを引き起こすようになり、
+     このアトリビュートは何の効果も持たなくなります。
+    </simpara>
+   </warning>
+
   </section>
 
   <section xml:id="returntypewillchange.synopsis">

reference/curl/constants.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: dec90c90d3662c5433f7c3972f8557321da7b11d Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: ee972f53e1a95967cd65c6de63ea4b422b987bd3 Maintainer: mumumu Status: ready -->
 <appendix xml:id="curl.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
@@ -213,6 +213,53 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.curlfollow-all">
+   <term>
+    <constant>CURLFOLLOW_ALL</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     <constant>CURLOPT_FOLLOWLOCATION</constant> に指定する値で、
+     リダイレクトの追跡を有効にしつつ、
+     <constant>CURLOPT_CUSTOMREQUEST</constant> で設定したカスタムのリクエストメソッドを、
+     リダイレクト後も含めた全てのリクエストで使い続けます。
+     PHP 8.5.0 以降 および cURL 8.13.0 以降で利用可能です。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.curlfollow-obeycode">
+   <term>
+    <constant>CURLFOLLOW_OBEYCODE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     <constant>CURLOPT_FOLLOWLOCATION</constant> に指定する値で、
+     HTTP のレスポンスコードに従いつつリダイレクトの追跡を有効にします。
+     <constant>CURLOPT_CUSTOMREQUEST</constant> で設定したカスタムのリクエストメソッドは保持されますが、
+     それが必要なリダイレクトのステータスコード(301, 302, 303 など)の場合は
+     <literal>GET</literal> に変更されます。
+     PHP 8.5.0 以降 および cURL 8.13.0 以降で利用可能です。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.curlfollow-firstonly">
+   <term>
+    <constant>CURLFOLLOW_FIRSTONLY</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     <constant>CURLOPT_FOLLOWLOCATION</constant> に指定する値で、
+     リダイレクトの追跡を有効にしますが、
+     <constant>CURLOPT_CUSTOMREQUEST</constant> で設定したカスタムのリクエストメソッドを使うのは
+     最初のリクエストだけです。
+     それ以降のリクエストは、リダイレクトのレスポンスコードが指示するメソッドに従います。
+     PHP 8.5.0 以降 および cURL 8.13.0 以降で利用可能です。
+    </simpara>
+   </listitem>
+  </varlistentry>
   <varlistentry xml:id="constant.curlftpauth-default">
    <term>
     <constant>CURLFTPAUTH_DEFAULT</constant>

reference/curl/constants_curl_getinfo.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f34918d8b2761af5b596b1b762753ee825c19cd8 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: ee972f53e1a95967cd65c6de63ea4b422b987bd3 Maintainer: mumumu Status: ready -->
 <variablelist xml:id="constant.curl-getinfo.constants" role="constant_list">
  <title><function>curl_getinfo</function></title>
  <varlistentry xml:id="constant.curlinfo-appconnect-time">
@@ -72,6 +72,18 @@
    </simpara>
   </listitem>
  </varlistentry>
+ <varlistentry xml:id="constant.curlinfo-conn-id">
+  <term>
+   <constant>CURLINFO_CONN_ID</constant>
+   (<type>int</type>)
+  </term>
+  <listitem>
+   <simpara>
+    転送で直近に使用した接続の ID。接続 ID は、同じ接続キャッシュを使用する全接続の中で一意であり、接続の再利用を見分けるのに役立ちます。
+    PHP 8.5.0 以降 および cURL 8.2.0 以降で利用可能です。
+   </simpara>
+  </listitem>
+ </varlistentry>
  <varlistentry xml:id="constant.curlinfo-connect-time">
   <term>
    <constant>CURLINFO_CONNECT_TIME</constant>
@@ -262,6 +274,18 @@
    </simpara>
   </listitem>
  </varlistentry>
+ <varlistentry xml:id="constant.curlinfo-httpauth-used">
+  <term>
+   <constant>CURLINFO_HTTPAUTH_USED</constant>
+   (<type>int</type>)
+  </term>
+  <listitem>
+   <simpara>
+    前回のリクエストで実際に使用した HTTP 認証方法を示すビットマスク。
+    PHP 8.5.0 以降 および cURL 8.12.0 以降で利用可能です。
+   </simpara>
+  </listitem>
+ </varlistentry>
  <varlistentry xml:id="constant.curlinfo-http-code">
   <term>
    <constant>CURLINFO_HTTP_CODE</constant>
@@ -461,6 +485,18 @@
    </simpara>
   </listitem>
  </varlistentry>
+ <varlistentry xml:id="constant.curlinfo-proxyauth-used">
+  <term>
+   <constant>CURLINFO_PROXYAUTH_USED</constant>
+   (<type>int</type>)
+  </term>
+  <listitem>
+   <simpara>
+    前回のリクエストで実際に使用したプロキシ認証方法を示すビットマスク。
+    PHP 8.5.0 以降 および cURL 8.12.0 以降で利用可能です。
+   </simpara>
+  </listitem>
+ </varlistentry>
  <varlistentry xml:id="constant.curlinfo-proxy-error">
   <term>
    <constant>CURLINFO_PROXY_ERROR</constant>
@@ -489,6 +525,19 @@
    </simpara>
   </listitem>
  </varlistentry>
+ <varlistentry xml:id="constant.curlinfo-queue-time-t">
+  <term>
+   <constant>CURLINFO_QUEUE_TIME_T</constant>
+   (<type>int</type>)
+  </term>
+  <listitem>
+   <simpara>
+    <constant>CURLMOPT_MAX_TOTAL_CONNECTIONS</constant> や類似のオプションで設定された制限により、
+    転送が開始される前に待機キューで保留されていた時間(マイクロ秒単位)。
+    PHP 8.5.0 以降 および cURL 8.6.0 以降で利用可能です。
+   </simpara>
+  </listitem>
+ </varlistentry>
  <varlistentry xml:id="constant.curlinfo-redirect-count">
   <term>
    <constant>CURLINFO_REDIRECT_COUNT</constant>
@@ -810,6 +859,19 @@
    </simpara>
   </listitem>
  </varlistentry>
+ <varlistentry xml:id="constant.curlinfo-used-proxy">
+  <term>
+   <constant>CURLINFO_USED_PROXY</constant>
+   (<type>int</type>)
+  </term>
+  <listitem>
+   <simpara>
+    前回の転送でプロキシを使用したかどうか。プロキシを使用した場合は <literal>1</literal> を、
+    使用しなかった場合は <literal>0</literal> を返します。
+    PHP 8.5.0 以降 および cURL 8.7.0 以降で利用可能です。
+   </simpara>
+  </listitem>
+ </varlistentry>
  <varlistentry xml:id="constant.curlinfo-posttransfer-time-t">
   <term>
    <constant>CURLINFO_POSTTRANSFER_TIME_T</constant>

reference/curl/constants_curl_setopt.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 525aa5f198d482c0d03be54ddee5af13b376ab99 Maintainer: nsfisis Status: ready -->
+<!-- EN-Revision: e7e81a179eabc75e1b37947c7696afd557cef656 Maintainer: nsfisis Status: ready -->
  <variablelist role="constant_list">
   <title><function>curl_setopt</function></title>
   <varlistentry xml:id="constant.curlopt-abstract-unix-socket">
@@ -1367,6 +1367,20 @@
     </para>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.curlopt-infilesize-large">
+   <term>
+    <constant>CURLOPT_INFILESIZE_LARGE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     リモートサイトにファイルをアップロードする際のファイルの予想サイズ (バイト単位) を指定します。
+     これは <constant>CURLOPT_INFILESIZE</constant> の 64 ビット版で、
+     2 GB を超えるサイズを指定できます。
+     PHP 8.5.0 以降で利用可能です。
+    </simpara>
+   </listitem>
+  </varlistentry>
   <varlistentry xml:id="constant.curlopt-interface">
    <term>
     <constant>CURLOPT_INTERFACE</constant>

reference/datetime/functions/mktime.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: df78bd1d232f2cd8df673accf5ba0e280695639b Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.mktime" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -255,11 +255,11 @@ print date('c', $nextyear) . "\n";
   <para>
    <example>
     <title>月の末日</title>
-    <para>
+    <simpara>
      指定した月の最後の日は次の月の -1 番目の日ではなく、"0" 番目の日
-     として表すことが可能です。以下の例はともに文字列"The last day in
+     として表すことが可能です。以下の例はともに文字列"Last day in
      Feb 2000 is: 29" を出力します。
-    </para>
+    </simpara>
     <programlisting role="php">
 <![CDATA[
 <?php

reference/dom/domelement/construct.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: df78bd1d232f2cd8df673accf5ba0e280695639b Maintainer: takagi Status: ready -->
 <refentry xml:id="domelement.construct" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMElement::__construct</refname>

reference/filter/book.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 53054bf8decc8648cf2e90a493692a161e2371af Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: mumumu Status: ready -->
 <book xml:id="book.filter" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="bundled" ?>
  <title>データのフィルタリング</title>
@@ -59,6 +59,9 @@
  &reference.filter.examples;
  &reference.filter.reference;
 
+ &reference.filter.filter.filterexception;
+ &reference.filter.filter.filterfailedexception;
+
 </book>
 <!-- Keep this comment at the end of the file
 Local variables:

reference/filter/constants.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 525aa5f198d482c0d03be54ddee5af13b376ab99 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1c5ff30e9ae64bd4fd7ebbd0cccfb1e642e1b02c Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 
@@ -159,6 +159,26 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.filter-throw-on-failure">
+   <term>
+    <constant>FILTER_THROW_ON_FAILURE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     検証フィルタが失敗した際に、&false; を返す代わりに
+     <exceptionname>Filter\FilterFailedException</exceptionname> をスローします。
+    </simpara>
+    <simpara>
+     任意の検証フィルタ
+     <constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>
+     と一緒に使えます。
+    </simpara>
+    <simpara>
+     PHP 8.5.0 以降で利用可能です。
+    </simpara>
+   </listitem>
+  </varlistentry>
  </variablelist>
 
  <variablelist xml:id="filter.constants.flags.sanitization">
@@ -267,7 +287,7 @@
     <simpara>
      <literal>"1"</literal>,
      2進数、8進数、16進数記法の <literal>1</literal>,
-     <literal>1.0</literal>,
+     科学的記法を含む <literal>1.0</literal>,
      <literal>"true"</literal>, <literal>true</literal>,
      <literal>"on"</literal>,
      <literal>"yes"</literal>
@@ -276,7 +296,7 @@
     <simpara>
      <literal>"0"</literal>,
      2進数、8進数、16進数記法の <literal>0</literal>,
-     <literal>0.0</literal>,
+     科学的記法を含む <literal>0.0</literal>,
      <literal>"false"</literal>, <literal>false</literal>,
      <literal>"off"</literal>,
      <literal>"no"</literal>,