Documentation update

diff --git a/ext/soap/TODO b/ext/soap/TODO
index 62dc6784737308658e7d17e218b2252aed62d574..70416df660224a241186b45fcfc59cf44f5a8180 100644 (file)
--- a/ext/soap/TODO
+++ b/ext/soap/TODO
@@ -81,6 +81,8 @@ Schema
        ? union
 ? support for user defined complex types
   ? full support for content model encoding/decoding
+  - <any>
+  - <anyAttribute>
 
 Transport
 ---------

diff --git a/ext/soap/readme.html b/ext/soap/readme.html
index 1284391396c83773c88c57f70bf8fe0ae45a9514..98efff3c5343c67c55fde549db977cca6e721268 100644 (file)
--- a/ext/soap/readme.html
+++ b/ext/soap/readme.html
@@ -157,7 +157,6 @@ remote SOAP clients over HTTP or HTTPS.
 <tr><td><a href="#ref.soap.soapserver.getfunctions">getFunctions</a> -- returns list of defined functions</td></tr>
 <tr><td><a href="#ref.soap.soapserver.setpersistence">setPersistence</a> -- sets persistence mode of SoapServer</td></tr>
 <tr><td><a href="#ref.soap.soapserver.handle">handle</a> -- handles a SOAP request</td></tr>
-<tr><td><a href="#ref.soap.soapserver.fault">fault</a> -- generates SOAP fault response</td></tr>
 </table>
 <a name="ref.soap.soapparam">
 <h4>SoapParam class</h4>
@@ -219,7 +218,6 @@ client side.
 <tr><td><a href="#ref.soap.soapserver.getfunctions">SoapServer::getFunctions</a> -- returns list of defined functions</td></tr>
 <tr><td><a href="#ref.soap.soapserver.setpersistence">SoapServer::setPersistence</a> -- sets persistence mode of SoapServer</td></tr>
 <tr><td><a href="#ref.soap.soapserver.handle">SoapServer::handle</a> -- handles a SOAP request</td></tr>
-<tr><td><a href="#ref.soap.soapserver.fault">SoapServer::fault</a> -- generates SOAP fault response</td></tr>
 <tr><td><a href="#ref.soap.soapparam.soapparam">SoapParam::SoapParam</a> -- SoapParam constructor</td></tr>
 <tr><td><a href="#ref.soap.soapvar.soapvar">SoapVar::SoapVar</a> -- SoapVar constructor</td></tr>
 <tr><td><a href="#ref.soap.soapheader.soapheader">SoapHeader::SoapHeader</a> -- SoapHeader constructor</td></tr>
@@ -256,7 +254,7 @@ is_soap_fault() functions checks if the given parameter is a SoapFault object.<b
     try {
         $client = SoapClient("some.wsdl");
         $result = $client->SomeFunction(...);
-    } catch {SoapFault $fault) {
+    } catch (SoapFault $fault) {
         trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faulstring})", E_ERROR);
     }
 ?&gt;</PRE></TD></TR></TABLE>
@@ -524,29 +522,6 @@ if the argument is omitted.
 ?&gt;
 </PRE></TD></TR></TABLE>
 
-<a name="ref.soap.soapserver.fault"></a>
-<h2>SoapServer::fault</h2>
-<p>(PHP 5)</p>
-<p>generates SOAP fault response</p>
-<h3>Description</h3>
-<p>void <b>fault</b>(string faultcode, string faultstring [, string faultactor [, mixed details]])</p>
-This function is useful when you like to send SOAP fault response from PHP handler.
-It never returns.
-<h4>Example</h4>
-<TABLE BORDER="0" BGCOLOR="#E0E0E0"><TR><TD><PRE CLASS="php">
-&lt;?php
-    function test($x) {
-        global $server;
-        $server->fault("Server","Some error message");
-    }
-
-    $server = new SoapServer(null,array('uri'=>"http://test-uri/"));
-    $server->addFunction("test");
-    $server->handle();
-?&gt;
-</PRE></TD></TR></TABLE>
-<p>See also: <a href="#ref.soap.soapfault.soapfault">SoapFault::SoapFault</a></p>
-
 <a name="ref.soap.soapparam.soapparam"></a>
 <h2>SoapParam::SoapParam</h2>
 <p>(PHP 5)</p>
@@ -638,9 +613,11 @@ Header element.
 <p>(PHP 5)</p>
 <p>SoapFault constructor</p>
 <h3>Description</h3>
-<p><b>SoapFault</b>(string faultcode, string faultstring [, string faultactor [, mixed details]])</p>
-This class is useful when you like to send SOAP fault response from PHP handler.
-<h4>Example</h4>
+<p><b>SoapFault</b>(string faultcode, string faultstring [, string faultactor [, mixed details [, string faultname [, mixed headerfault]]]])</p>
+This class is useful when you like to send SOAP fault response from PHP handler.<br>
+<b>faultcode</b>, <b>faultstring</b>, <b>faultactor</b> and <b>details</b> are standard elements of SOAP Fault;<br>
+<b>faultname</b> is an optional parameter that can be used to select proper fault encoding from WSDL.<br>
+<b>headerfault</b> is an optional parameter that can be used during SOAP header handling to report error in response header.
 <h4>Example</h4>
 <TABLE BORDER="0" BGCOLOR="#E0E0E0"><TR><TD><PRE CLASS="php">
 &lt;?php
@@ -665,6 +642,5 @@ This class is useful when you like to send SOAP fault response from PHP handler.
     $server->handle();
 ?&gt;
 </PRE></TD></TR></TABLE>
-<p>See also: <a href="#ref.soap.soapserver.fault">SoapServer::fault</a></p>
 </BODY>
 </HTML>
\ No newline at end of file