[PHP 8.4] Curl new options and constants #4069 を取り込み

language/predefined/sensitiveparametervalue/construct.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ce78d59569fcae6286c46abe1b781a0b6fc594c0 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: c29164e0e6db5f24c46d8f98d520003cfde9d1fa Maintainer: mumumu Status: ready -->
 <refentry xml:id="sensitiveparametervalue.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>SensitiveParameterValue::__construct</refname>

reference/curl/constants.xml

@@ -1397,6 +1397,28 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.curl-http-version-3">
+   <term>
+    <constant>CURL_HTTP_VERSION_3</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Available as of PHP 8.4.0 and cURL 7.66.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.curl-http-version-3only">
+   <term>
+    <constant>CURL_HTTP_VERSION_3ONLY</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Available as of PHP 8.4.0 and cURL 7.88.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
   <varlistentry xml:id="constant.curl-http-version-none">
    <term>
     <constant>CURL_HTTP_VERSION_NONE</constant>
@@ -2307,6 +2329,28 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.curl-prereqfunc-ok">
+   <term>
+    <constant>CURL_PREREQFUNC_OK</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Available as of PHP 8.4.0 and cURL 7.80.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.curl-prereqfunc-abort">
+   <term>
+    <constant>CURL_PREREQFUNC_ABORT</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Available as of PHP 8.4.0 and cURL 7.80.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
  </variablelist>
  &reference.curl.constants-curl-setopt;
  &reference.curl.constants-curl-share-setopt;

reference/curl/constants_curl_getinfo.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8ff19ed3d6cc23f8349f589d09736a859c0aa2e3 Maintainer: mumumu Status: working -->
+<!-- EN-Revision: c29164e0e6db5f24c46d8f98d520003cfde9d1fa Maintainer: mumumu Status: working -->
 <variablelist xml:id="constant.curl-getinfo.constants" role="constant_list">
  <title><function>curl_getinfo</function></title>
  <varlistentry xml:id="constant.curlinfo-appconnect-time">
@@ -778,4 +778,16 @@
    </simpara>
   </listitem>
  </varlistentry>
+ <varlistentry xml:id="constant.curlinfo-posttransfer-time-t">
+  <term>
+   <constant>CURLINFO_POSTTRANSFER_TIME_T</constant>
+   (<type>int</type>)
+  </term>
+  <listitem>
+   <simpara>
+    Time it took from the start until the last byte is sent, in microseconds.
+    Available as of PHP 8.4.0 and cURL 8.10.0
+   </simpara>
+  </listitem>
+ </varlistentry>
 </variablelist>

reference/curl/functions/curl-getinfo.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 56171c30f4f4bb558537d9f5b400f21fdd2ebee8 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: c29164e0e6db5f24c46d8f98d520003cfde9d1fa Maintainer: hirokawa Status: ready -->
 <!-- Reviewed: no -->
 <!-- CREDITS: takagi,mumumu -->
 <refentry xml:id="function.curl-getinfo" xmlns="http://docbook.org/ns/docbook">
@@ -183,6 +183,11 @@
       をコールしたときに <constant>CURLINFO_HEADER_OUT</constant> を設定した場合のみです)
      </simpara>
     </listitem>
+    <listitem>
+     <simpara>
+      "posttransfer_time_us" (PHP 8.4.0 以降かつ cURL 8.10.0 以降で利用可能。)
+     </simpara>
+    </listitem>
    </itemizedlist>
    プライベートデータはこの連想配列には含まれず、<constant>CURLINFO_PRIVATE</constant> オプションで個別に取得しなければいけないことに注意しましょう。
   </para>
@@ -200,6 +205,12 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        定数 <constant>CURLINFO_POSTTRANSFER_TIME_T</constant> と <literal>posttransfer_time_us</literal> が追加されました。(Curl 8.10.0 以降).
+       </entry>
+      </row>
       <row>
        <entry>8.3.0</entry>
        <entry>

reference/curl/functions/curl-setopt.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 56171c30f4f4bb558537d9f5b400f21fdd2ebee8 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: c29164e0e6db5f24c46d8f98d520003cfde9d1fa Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,mumumu -->
 <refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -68,6 +68,13 @@
       </row>
      </thead>
      <tbody>
+     <row>
+       <entry>8.4.0</entry>
+       <entry>
+        <constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant> は意味を成さず、
+        スレッドセーフな PHP ビルドで有効にしても警告は表示されなくなりました。
+       </entry>
+      </row>
       &curl.changelog.handle-param;
       <row>
        <entry>7.3.15, 7.4.3</entry>

reference/curl/functions/curl-version.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: c29164e0e6db5f24c46d8f98d520003cfde9d1fa Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.curl-version" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -73,6 +73,13 @@
        <entry>protocols</entry>
        <entry>cURL がサポートするプロトコル名の配列</entry>
       </row>
+      <row>
+       <entry>feature_list</entry>
+       <entry>
+        全ての既知のcURL機能の連想配列と、それらがサポートされている(&true;)
+        もしくはサポートされていない(&false;) かどうかを示す値
+       </entry>
+      </row>
      </tbody>
     </tgroup>
    </informaltable>
@@ -90,6 +97,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <literal>features_list</literal> が追加されました。
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>

reference/curl/setup.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b08895614bbc3bfb0273a41c29eda921161538c7 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: c29164e0e6db5f24c46d8f98d520003cfde9d1fa Maintainer: takagi Status: ready -->
 <!-- CREDITS: shimooka,hirokawa,mumumu -->
 
 <chapter xml:id="curl.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -15,6 +15,7 @@
    libcurl 7.10.5 以降が必要です。
    PHP 7.3.0 以降では、7.15.5 以降が必要です。
    PHP 8.0.0 以降では、7.29.0 以降が必要です。
+   PHP 8..0 以降では、7.61.0 以降が必要です。
   </para>
  </section>
  <!-- }}} -->