soap を原文の変更に追従 (5ファイル)

appendices/migration84/new-features.xml

@@ -536,8 +536,8 @@ $object = $reflector->newLazyGhost($initializer);
   <title>SOAP</title>
 
   <simpara>
-   クラスマップでの名前空間のクラーク式記法のサポートが追加されました。
-   クラスマップ内でクラーク式記法を使用して、
+   クラスマップでの名前空間の Clark 記法のサポートが追加されました。
+   クラスマップ内で Clark 記法を使用して、
    特定の名前空間の型を特定のクラスに解決するエントリを指定できるようになりました。
    例: <code>'{http://example.com}foo' => 'FooClass'</code>
   </simpara>

reference/soap/soapclient.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 603435cd84951fc720eded819c62ef2466d21b5c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: takagi Status: ready -->
 <reference xml:id="class.soapclient" 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><classname>SoapClient</classname> クラス</title>
@@ -73,7 +73,7 @@
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>private</modifier>
-     <type class="union"><type>resource</type><type>null</type></type>
+     <type class="union"><type>array</type><type>null</type></type>
      <varname linkend="soapclient.props.typemap">typemap</varname>
      <initializer>null</initializer>
     </fieldsynopsis>
@@ -488,8 +488,14 @@
     <varlistentry xml:id="soapclient.props.typemap">
      <term><varname>typemap</varname></term>
      <listitem>
-      <para>
-      </para>
+      <simpara>
+       XML から PHP への独自の型変換に使う型マッピングの配列です。
+       型マッピングが設定されていない場合は &null; です。
+       PHP 8.4.0 以降、このプロパティは <type>array</type> 型です。
+       これより前のバージョンでは <type>resource</type> 型でした。
+       このプロパティを <function>is_resource</function> でチェックしているコードは、
+       それに合わせて修正する必要があります。
+      </simpara>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="soapclient.props.uri">

reference/soap/soapclient/construct.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f309e78f9439ae5d063a284cefb4b375233aa785 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="soapclient.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -405,6 +405,12 @@
            <link linkend="object.get">__get()</link> が
            コールされる点にも注意して下さい。
           </para>
+          <simpara>
+           PHP 8.4.0 以降では、特定の XML 名前空間の型をマッピングするために、
+           <literal>{namespace}type</literal> 形式の Clark 記法でキーを指定することもできます。
+           たとえば <literal>'{http://example.com}foo'</literal> のように指定します。
+           同じ型名が複数の名前空間で定義されている場合に役立ちます。
+          </simpara>
          </listitem>
         </varlistentry>
         <varlistentry xml:id="soapclient.construct.options.typemap">

reference/soap/soapserver/construct.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fe4e8b87d18f17394e7177917c498774b062448c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka -->
 
 <refentry xml:id="soapserver.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -44,12 +44,15 @@
        内部の文字エンコーディング (<literal>encoding</literal>),
        アクターの URI (<literal>actor</literal>) を指定することができます。
       </para>
-      <para>
+      <simpara>
        <literal>classmap</literal> オプションにより、WSDL 型を PHP
        のクラスにマッピングすることが可能です。
        このオプションには、キーとしてWSDL 型、値として PHP
        クラスの名前を持つ配列を指定する必要があります。
-      </para>
+       PHP 8.4.0 以降では、特定の XML 名前空間の型をマッピングするために、
+       <literal>{namespace}type</literal> 形式の Clark 記法でキーを指定することもできます。
+       たとえば <literal>'{http://example.com}foo'</literal> のように指定します。
+      </simpara>
       <para>
        <literal>typemap</literal> オプションは、型マッピングの配列です。
        この配列のキーは <literal>type_name</literal>、

reference/soap/soapserver/setpersistence.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: takagi Status: ready -->
+<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka -->
 
 <refentry xml:id="soapserver.setpersistence" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -26,7 +26,7 @@
      持続モード
      <constant>SOAP_PERSISTENCE_SESSION</constant>
      は、そのクラスのオブジェクトについてのみ持続させます。
-     クラスのスタティックなデータについては対象となりません。
+     クラスの static なデータについては対象となりません。
      self::$bar ではなく <varname>$this->bar</varname> を使用しましょう。
     </para>
    </note>
@@ -75,7 +75,35 @@
    &return.void;
   </para>
  </refsect1>
-
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       session 拡張モジュールが共有モジュールとしてビルドされている場合も
+       <constant>SOAP_PERSISTENCE_SESSION</constant> が動作するようになりました。
+       これより前のバージョンでは、この場合は黙って失敗していました。
+       一方、session 拡張モジュールが利用できない状態で
+       <constant>SOAP_PERSISTENCE_SESSION</constant> を指定すると、
+       <methodname>SoapServer::setPersistence</methodname> が
+       <exceptionname>Error</exceptionname> をスローするようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

reference/soap/soapvar/construct.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fe4e8b87d18f17394e7177917c498774b062448c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka -->
 
 <refentry xml:id="soapvar.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -92,6 +92,14 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <literal>xsd:dateTime</literal> など、日付や時刻を表す型の要素の値に
+       <classname>DateTimeInterface</classname> のインスタンスを使うと、
+       空文字列ではなく ISO 8601 形式でシリアライズされるようになりました。
+      </entry>
+     </row>
      <row>
       <entry>8.0.3</entry>
       <entry>