grammar (not finished)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@177333 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Sean Coates 2005-01-16 05:28:55 +00:00
parent aa38e693e3
commit fb2a556169
4 changed files with 28 additions and 24 deletions

View file

@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.1 $ -->
<!-- $Revision: 1.2 $ -->
<refentry id="function.soap-soapclient-call">
<refnamediv>
<refname>SoapClient->__call()</refname>
@ -22,25 +22,28 @@
</methodsynopsis>
</classsynopsis>
<para>
This is a low level API function to make a SOAP call. Usually in WSDL mode
This is a low level API function that is used to make a SOAP call. Usually,
in WSDL mode,
you can simply call SOAP functions as <classname>SoapClient</classname>
methods. It is useful for non-WSDL mode when <literal>soapaction</literal>
is unknown, <literal>uri</literal> differs from the default or when you like
to send and/or receive SOAP Headers.
methods. This method useful in non-WSDL mode when <literal>soapaction</literal>
is unknown, <literal>uri</literal> differs from the default or when sending
and/or receiving SOAP Headers.
</para>
<para>
On error, a call to a SOAP function can cause PHP exceptions or return a
<classname>SoapFault</classname> object if exceptions was disabled.
To check if the function call failed catch the SoapFault exceptions or
On error, a call to a SOAP function can cause PHP to throw exceptions or return a
<classname>SoapFault</classname> object if exceptions are disabled.
To check if the function call failed to catch the SoapFault exceptions,
check the result with <function>is_soap_fault</function>.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
SOAP functions may return one or several values. In the first case it will
return just the value of output parameter, in the second it will return
the associative array with named output parameters.
SOAP functions may return one, or multiple values. If only one value is returned
by the SOAP function, the return value of <literal>__call</literal> will be
a simple value (e.g. an integer, a string, etc). If multiple values are
returned, <literal>__call</literal> will return
an associative array of named output parameters.
</para>
</refsect1>
<refsect1 role="examples">

View file

@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.1 $ -->
<!-- $Revision: 1.2 $ -->
<refentry id="function.soap-soapclient-construct">
<refnamediv>
<refname>SoapClient->__construct()</refname>
@ -18,7 +18,7 @@
</constructorsynopsis>
</classsynopsis>
<para>
This constructor allows creating <classname>SoapClient</classname> objects
This constructor creates <classname>SoapClient</classname> objects
in <literal>WSDL</literal> or <literal>non-WSDL</literal> mode.
</para>
</refsect1>
@ -39,15 +39,15 @@
<term><parameter>options</parameter></term>
<listitem>
<para>
An array of option. If working in WSDL mode, this parameter is optional.
An array of options. If working in WSDL mode, this parameter is optional.
If working in non-WSDL mode, you must set the <literal>location</literal>
and <literal>uri</literal> options, where <literal>location</literal> is
a URL to request and <literal>uri</literal> is a target namespace of the
the URL to request and <literal>uri</literal> is the target namespace of the
SOAP service.
</para>
<para>
The <literal>style</literal> and <literal>use</literal> options only work in
non-WSDL mode. In WSDL mode, they comes from the WSDL file.
non-WSDL mode. In WSDL mode, they come from the WSDL file.
</para>
<para>
The <literal>soap_version</literal> option specifies whether to use SOAP
@ -55,7 +55,7 @@
</para>
<para>
For HTTP authentication, you may use the <literal>login</literal> and
<literal>password</literal> options. For making a HTTP connection through
<literal>password</literal> options. For making an HTTP connection through
a proxy server, use the options <literal>proxy_host</literal>,
<literal>proxy_port</literal>, <literal>proxy_login</literal>
and <literal>proxy_password</literal>.

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<section id="soap.configuration">
&reftitle.runtime;
&extension.runtime;
@ -48,7 +48,7 @@
</term>
<listitem>
<para>
Enables or disables WSDL caching feature.
Enables or disables the WSDL caching feature.
</para>
</listitem>
</varlistentry>
@ -59,7 +59,7 @@
</term>
<listitem>
<para>
Sets the directory name where SOAP extension will put cache files.
Sets the directory name where the SOAP extension will put cache files.
</para>
</listitem>
</varlistentry>
@ -70,8 +70,8 @@
</term>
<listitem>
<para>
(time to live) Sets the number of second while cached file will be used
instead of original one.
Sets the number of seconds (time to live) that cached files will be used
instead the originals.
</para>
</listitem>
</varlistentry>

View file

@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -->
<reference id="ref.soap">
<title>SOAP Functions</title>
@ -47,7 +47,8 @@
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.soap-soapclient-construct' /> - construct a new SoapClient object</para>
<para><xref linkend='function.soap-soapclient-construct' /> -
constructs a new SoapClient object</para>
</listitem>
</itemizedlist>
</section>