cvs: peardoc /ja/package/webservices/xml-rpc api.xml examples.xml intro.xml support.xml
| From: | Haruki Setoyama | Date: | Sat, 10 Sep 2005 09:44:04 +0000 |
| Subject: | cvs: peardoc /ja/package/webservices/xml-rpc api.xml examples.xml intro.xml support.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-6795@lists.php.net to get a copy of this message | ||
haruki Sat Sep 10 05:44:04 2005 EDT
Added files:
/peardoc/ja/package/webservices/xml-rpc api.xml examples.xml
intro.xml support.xml
Log:
new translations
http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/api.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/api.xml +++ peardoc/ja/package/webservices/xml-rpc/api.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.api"> <refnamediv> <refname>API</refname> <refpurpose>ããã±ã¼ã¸å ã®ã¯ã©ã¹ã®ããã¥ã¡ã³ã</refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.api.client"> <title>XML_RPC_Client</title> <para> ããã¯ãXML-RPC ãµã¼ãã®ã¯ã©ã¤ã¢ã³ãã表ç¾ããããã«ä½¿ç¨ããã¾ãã </para> <refsect2> <title>çæ</title> <para> ã³ã³ã¹ãã©ã¯ã¿ã¯ä»¥ä¸ã®ãããªæ§æã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$client = new XML_RPC_Client</funcdef> <paramdef> string <parameter>$path</parameter> </paramdef> <paramdef> string <parameter>$server</parameter> </paramdef> <paramdef> integer <parameter><optional>$port</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$proxy</optional></parameter> </paramdef> <paramdef> integer <parameter><optional>$proxy_port</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$proxy_user</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$proxy_pass</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <variablelist> <varlistentry> <term> &type.string; <parameter>$path</parameter> </term> <listitem> <para> ãªã¯ã¨ã¹ããéä¿¡ããã RPC ãµã¼ãã¹ã¯ãªããã®ãã¹ã¨ååã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$server</parameter> </term> <listitem> <para> æ¥ç¶å ãªã¢ã¼ããµã¼ãã® URL ããããã³ã«ãæå®ããã¦ãããã ã㤠$port ã 443 ã§ãã£ãå ´å㯠ssl:// ã使ç¨ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.int; <parameter>$port</parameter> </term> <listitem> <para> ãªã¢ã¼ããµã¼ãã«æ¥ç¶ããéã®ãã¼ããããã©ã«ã㯠80 ã§ã http:// æ¥ç¶ã表ãã¾ãã443 ãæå®ãã㨠https:// ããã³ ssl:// æ¥ç¶ã¨ãªãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$proxy</parameter> </term> <listitem> <para> ãã使ç¨ãããªãããããã·ãµã¼ãã® URL ã ãããã³ã«ãæå®ããã¦ãããã ã㤠$port ã 443 ã§ãã£ãå ´å㯠ssl:// ã使ç¨ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.int; <parameter>$proxy_port</parameter> </term> <listitem> <para> ãªã¢ã¼ããµã¼ãã«æ¥ç¶ããéã®ãã¼ããããã©ã«ã㯠8080 ã§ã http:// æ¥ç¶ã表ãã¾ãã443 ãæå®ãã㨠https:// ããã³ ssl:// æ¥ç¶ã¨ãªãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$proxy_user</parameter> </term> <listitem> <para> ãããã·ãµã¼ãã«ã¢ã¯ã»ã¹ããããã®ã¦ã¼ã¶åã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$proxy_pass</parameter> </term> <listitem> <para> ãããã·ãµã¼ãã«ã¢ã¯ã»ã¹ããããã®ãã¹ã¯ã¼ãã </para> </listitem> </varlistentry> </variablelist> </para> <para> <note> <para> SSL æ¥ç¶ã使ç¨ããã«ã¯ã <ulink url="http://php.net/openssl"> <literal>openssl</literal></ulink> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ã㦠PHP ãã¤ã³ã¹ãã¼ã«ããã¦ããå¿ è¦ãããã¾ãã </para> </note> </para> <para> <emphasis>betty.userland.com</emphasis> ã«ãã Userland ã® XML-RPC ãµã¼ãã«åãåãããããã®ã¯ã©ã¤ã¢ã³ãè¨å®ã®ä¾ã¯ ãã®ããã«ãªãã¾ãã </para> <programlisting role="php"> <![CDATA[ $client = new XML_RPC_Client('/RPC2', 'betty.userland.com'); ]]> </programlisting> </refsect2> <refsect2> <title>ã¡ã½ãã</title> <para> ãã®ã¯ã©ã¹ã¯ä»¥ä¸ã®ã¡ã½ããããµãã¼ããã¦ãã¾ãã </para> <refsect3> <title><function>send</function></title> <para> ãã®ã¡ã½ããã¯ä»¥ä¸ã®ãããªæ¸å¼ã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$response = $client->send</funcdef> <paramdef><parameter>$xmlrpc_message</parameter></paramdef> <paramdef><parameter><optional>$timeout</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$xmlrpc_message</parameter> 㯠<classname>XML_RPC_Message</classname> ã®ã¤ã³ã¹ã¿ã³ã¹ã§ã <parameter>$response</parameter> 㯠<classname>XML_RPC_Response</classname> ã®ã¤ã³ã¹ã¿ã³ã¹ã§ãï¼<xref linkend="package.webservices.xml-rpc.api.response" /> ãåç §ãã ããï¼ã </para> <para> <parameter>$timeout</parameter> ã¯ãªãã·ã§ã³ã§ãæå®ããªãã£ãå ´å㯠<literal>0</literal>ï¼æ°¸é ã«å¾ ã¡ç¶ããï¼ã¨ãªãã¾ãããã®å¤ã¯ <function>fsockopen</function> ã«æ¸¡ããã¾ãã </para> <para> ãã <parameter>$response</parameter> ã®å 容ã <classname>XML_RPC_Response</classname> ã§ã¯ãªã <literal>0</literal> ã§ãã£ãå ´åããã㯠I/O ã¨ã©ã¼ãçºçãããã¨ã 表ãã¾ããçºçãã I/O ã¨ã©ã¼ã®å 容ã«ã¤ãã¦ã¯ã <varname>$client->errno</varname> ããã³ <varname>$client->errstring</varname> ã®å¤ããç¥ããã¨ãã§ãã¾ãã </para> <para> ä½ã¬ãã«ã®ã¨ã©ã¼ã«å ããåãåããå ã® XML-RPC ãµã¼ãã <classname>XML_RPC_Response</classname> ãªãã¸ã§ã¯ãã®ä¸ã§ã¨ã©ã¼ã è¿ããã¨ãããã¾ãããããã®ã¨ã©ã¼ãå¦çããæ¹æ³ã«ã¤ãã¦ã¯ <xref linkend="package.webservices.xml-rpc.api.response" /> ãåç §ãã ããã </para> </refsect3> <refsect3> <title><function>setCredentials</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setCredentials</funcdef> <paramdef><parameter>$username</parameter></paramdef> <paramdef><parameter>$password</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã®ã¡ã½ããã¯ãã¯ã©ã¤ã¢ã³ãããµã¼ãã«å¯¾ããèªè¨¼å¦çãè¡ãéã® ã¦ã¼ã¶åã¨ãã¹ã¯ã¼ããæå®ãã¾ããããã©ã«ãã®éä¿¡ï¼HTTPï¼ã§ã¯ã ãããã®æ å ±ã HTTP ãã¼ã·ãã¯èªè¨¼ã«ä½¿ç¨ããã¾ãã </para> </refsect3> <refsect3> <title><function>setCertificate</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setCertificate</funcdef> <paramdef><parameter>$certificate</parameter></paramdef> <paramdef><parameter>$passphrase</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã®ã¡ã½ããã¯ããªã¢ã¼ããµã¼ãã¨ã® SSL éä¿¡ãè¡ãéã«ä½¿ç¨ããã ãªãã·ã§ã³ã®è¨¼ææ¸ã¨ãã¹ãã¬ã¼ãºãè¨å®ãã¾ãã </para> <para> <parameter>certificate</parameter> ãã©ã¡ã¼ã¿ã¯ãPEM ãã©ã¼ããã㮠証ææ¸ãã¡ã¤ã«åã§ããå¿ è¦ãããã¾ãã <parameter>passphrase</parameter> ãã©ã¡ã¼ã¿ã¯ããã®è¨¼ææ¸ã使ç¨ããããã« å¿ è¦ãªãã¹ã¯ã¼ããå«ãã§ããå¿ è¦ãããã¾ãã </para> <para> ããã使ç¨ããã«ã¯ãPHP ã®ã³ã³ãã¤ã«æã« <literal>openssl</literal> æ¡å¼µã¢ã¸ã¥ã¼ã«ãçµã¿è¾¼ãã§ããå¿ è¦ãããã¾ãã </para> </refsect3> <!-- methods don't exist (yet) <refsect3> <title><function>setSSLVerifyPeer</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setSSLVerifyPeer</funcdef> <paramdef><parameter>$i</parameter></paramdef> </funcprototype> </funcsynopsis> <para> This method defines whether connections made to XML-RPC backends via HTTPS should verify the remote host's SSL certificate, and cause the connection to fail if the cert verification fails. $i should be a boolean value. </para> </refsect3> <refsect3> <title><function>setSSLVerifyHost</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setSSLVerifyHost</funcdef> <paramdef><parameter>$i</parameter></paramdef> </funcprototype> </funcsynopsis> <para> This method defines whether connections made to XML-RPC backends via HTTPS should verify the remote host's SSL certificate's common name (CN). By default, only the existence of a CN is checked. $i should be an integer value; 0 to not check the CN at all, 1 to merely check for its existence, and 2 to check that the CN on the certificate matches the hostname that is being connected to. </para> </refsect3> --> <refsect3> <title><function>setDebug</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setDebug</funcdef> <paramdef><parameter>$debugOn</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$debugOn</parameter> 㯠<literal>0</literal> ããã㯠<literal>1</literal> ã®ã©ã¡ããã§ãã¯ã©ã¤ã¢ã³ãã®ãã©ã¦ã¶ã«ãããã°æ å ±ã 表示ãããå¦ããæå®ãã¾ããããã©ã«ãã§ã¯ãã®æ å ±ã表示ãã¾ããã </para> <para> ãããã°æ å ±ã®ä¸ã«ã¯ XML-RPC ãµã¼ããè¿ãåãåããçµæã®çãã¼ã¿ãå«ã¾ãã ã¾ããµã¼ãããè¿ãããå¤ã表ãããã«ã¯ã©ã¤ã¢ã³ããä½æãããã¨ãã PHP ã®å¤ãå«ã¾ãã¾ãããµã¼ããè¿ãå 容ãæ£ç¢ºã«ç¢ºèªãããã¨ãã§ããã®ã§ã ãã®ãªãã·ã§ã³ã¯ãµã¼ãã®ãããã°æã«æç¨ã§ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.message" xreflabel="XML_RPC_Message"> <title>XML_RPC_Message</title> <para> ãã®ã¯ã©ã¹ã¯ XML-RPC ãµã¼ãã¸ã®ãªã¯ã¨ã¹ãã表ãã¾ããã¯ã©ã¤ã¢ã³ã㯠<classname>XML_RPC_Message</classname> ããµã¼ãã«éä¿¡ãã <classname>XML_RPC_Response</classname> ãåãåãã¾ãã </para> <refsect2> <title>çæ</title> <para> ã³ã³ã¹ãã©ã¯ã¿ã¯ä»¥ä¸ã®ãããªæ§æã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$msg = new XML_RPC_Message</funcdef> <paramdef><parameter>$methodName</parameter></paramdef> <paramdef><parameter>$parameterArray</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$methodName</parameter> ã¯èµ·åãããã¡ã½ããã®ååã§ã <parameter>$parameterArray</parameter> 㯠<classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã®é åã§ãã <emphasis>US state name</emphasis> ãµã¼ãã«ã¡ãã»ã¼ã¸ãéä¿¡ããä¾ã§ãã </para> <programlisting role="php"> <![CDATA[ require_once "XML/RPC.php"; $msg = new XML_RPC_Message("examples.getStateName", array(new XML_RPC_Value(23, "int"))); ]]> </programlisting> <para> ãã®ä¾ã§ã¯å·çªå· 23 ã®å·ã®ååãåãåããã¦ãã¾ãã <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã«ã¤ãã¦ã® 詳細ãªæ å ±ã¯ <xref linkend="package.webservices.xml-rpc.api.value" /> ãåç §ãã ããã </para> </refsect2> <refsect2> <title>ã¡ã½ãã</title> <refsect3> <title><function>serialize</function></title> <funcsynopsis> <funcprototype> <funcdef>$outString = $msg->serialize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> XML-RPC ã¡ãã»ã¼ã¸ã表ã XML æååãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>addParam</function></title> <funcsynopsis> <funcprototype> <funcdef>$msg->addParam</funcdef> <paramdef><parameter>$xmlrpcVal</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã®ã¡ã½ããã®ã³ã¼ã«ã«ããããã©ã¡ã¼ã¿ãªã¹ãã« <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ã <parameter>$xmlrpcVal</parameter> ã追å ãã¾ãã </para> </refsect3> <refsect3> <title><function>getParam</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $msg->getParam</funcdef> <paramdef><parameter>$n</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ã¡ãã»ã¼ã¸ä¸ã® <parameter>$n</parameter> çªç®ã®ãã©ã¡ã¼ã¿ãåå¾ãã¾ãã ãã®ã¡ã½ããã使ç¨ã§ãããã©ããã¯ãµã¼ãã®å®è£ ã«ä¾åãã¾ãã ãããã©ã¡ã¼ã¿ãåå¨ããªãå ´å㯠<literal>undef</literal> ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>getNumParams</function></title> <funcsynopsis> <funcprototype> <funcdef>$n = $msg->getNumParams</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> ã¡ãã»ã¼ã¸ã«ä»å±ãããã©ã¡ã¼ã¿ã®æ°ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>method</function></title> <funcsynopsis> <funcprototype> <funcdef>$methName=$msg->method</funcdef> <paramdef></paramdef> </funcprototype> <funcprototype> <funcdef>$msg->method</funcdef> <paramdef><parameter>$methName</parameter></paramdef> </funcprototype> </funcsynopsis> <para> XML-RPC ã¡ãã»ã¼ã¸ä¸ã«å«ã¾ããã¡ã½ãããåå¾ãããã¯è¨å®ãã¾ãã </para> </refsect3> <refsect3> <title><function>parseResponse</function></title> <funcsynopsis> <funcprototype> <funcdef>$response = $msg->parseResponse</funcdef> <paramdef><parameter>$xmlString</parameter></paramdef> </funcprototype> </funcsynopsis> <para> æåå <parameter>$xmlString</parameter> ã«å«ã¾ãã XML-RPC ãµã¼ãããã® å¿çãåãåãã<classname>XML_RPC_Response</classname> ãªãã¸ã§ã¯ãã æ§ç¯ãã¦ãããè¿ãã¾ããã¾ãé©åãªã¨ã©ã¼ã³ã¼ããè¨å®ãã¾ãã </para> <para> ãã®ã¡ã½ããã¯ãè¦ã¤ãã£ã HTTP/MIME ãããããã¹ã¦å¦çãã¾ãã </para> </refsect3> <refsect3> <title><function>parseResponseFile</function></title> <funcsynopsis> <funcprototype> <funcdef>$response = $msg->parseResponseFile</funcdef> <paramdef><parameter>$fileHandle</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã¡ã¤ã«ãã³ãã« <parameter>$fileHandle</parameter> ãã XML-RPC ãµã¼ãã®å¿çãèªã¿è¾¼ã¿ãããã <function>parseResponse</function> ã«æ¸¡ãã¾ãã </para> <para> ãã®ã¡ã½ããã¯ãäºåã«ç¨æããããã¡ã¤ã«ããå¿çãçæããéã«æç¨ã§ãã ã¾ããè¦ã¤ãã£ã HTTP ãããããã¹ã¦å¦çãã¾ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.response" xreflabel="XML_RPC_Response"> <title>XML_RPC_Response</title> <para> ãã®ã¯ã©ã¹ã¯ãXML-RPC ãªã¯ã¨ã¹ãã«å¯¾ããå¿çãæ ¼ç´ããããã«ä½¿ç¨ããã¾ãã ãµã¼ãã®ã¡ã½ãããã³ãã©ã¯ <classname>XML_RPC_Response</classname> ã ä½æããè¿ãå¤ã¨ãã¦ããã渡ãã¾ãã <classname>XML_RPC_Client</classname> ã¯ã©ã¹ã® <function>send</function> ã¡ã½ãããå®è¡ããéã«ãããã¨åãå¤ãè¿ããã¾ãã </para> <refsect2> <title>çæ</title> <funcsynopsis> <funcprototype> <funcdef>$resp = new XML_RPC_Response</funcdef> <paramdef><parameter>$xmlrpcval</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$resp = new XML_RPC_Response</funcdef> <paramdef><parameter>0</parameter></paramdef> <paramdef><parameter>$errcode</parameter></paramdef> <paramdef><parameter>$errstring</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ã²ã¨ã¤ãã®ã¤ã³ã¹ã¿ã³ã¹ã¯ãä½ã®åé¡ããªãå¦çãå®è¡ãããéã«ä½¿ç¨ããã¾ãã <parameter>$xmlrpcval</parameter> 㯠<classname>XML_RPC_Value</classname> ã®å¤ã§ãã¡ã½ããã®å®è¡çµæã æ ¼ç´ããã¦ãã¾ãã </para> <para> 2 çªç®ã®å½¢å¼ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ã失ææã«ä½¿ç¨ããã¾ããã©ãã«åé¡ã ãã£ãã®ãã示ãããã«ã<parameter>$errcode</parameter> ããã³ <parameter>$errstring</parameter> ã使ç¨ããã¾ãã渡ãããã¨ã©ã¼ã³ã¼ã㮠詳細ã«ã¤ãã¦ã¯ <xref linkend="package.webservices.xml-rpc.api.server" /> ãåç §ãã ããã </para> </refsect2> <refsect2> <title>ã¡ã½ãã</title> <refsect3> <title><function>faultCode</function></title> <funcsynopsis> <funcprototype> <funcdef>$fn = $resp->faultCode</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> XML-RPC ã¬ã¹ãã³ã¹ <parameter>$resp</parameter> ããã失æã®ã³ã¼ãã æ´æ°å¤ã§è¿ãã¾ããã¼ãã¯æåãããã以å¤ã®å¤ã¯å¤±æãæå³ãã¾ãã </para> </refsect3> <refsect3> <title><function>faultString</function></title> <funcsynopsis> <funcprototype> <funcdef>$fs = $resp->faultString</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <varname>$resp->faultCode</varname> ã示ã失æã®å 容ãã 人éãèªããå½¢å¼ã§è¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>value</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $resp->value</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> ãµã¼ãããéä¿¡ãããè¿ãå¤ãå«ã¾ãã <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ããè¿ãã¾ããå¿çã® <varname>faultCode</varname> ãã¼ã以å¤ã® å ´åããã®ã¡ã½ãããè¿ãå¤ã使ç¨ããã¹ãã§ã¯ããã¾ããï¼è¿ãå¤ã¯ ãªãã¸ã§ã¯ãã§ãããªãããããã¾ããï¼ã </para> </refsect3> <refsect3> <title><function>serialize</function></title> <funcsynopsis> <funcprototype> <funcdef>$outString = $resp->serialize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> å¿çããXML æååå½¢å¼ã§è¿ãã¾ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.value" xreflabel="XML_RPC_Value"> <title>XML_RPC_Value</title> <para> ããã¯ãå¤ãã®å¤§å¤ãªä»äºãæ å½ãããã®ã§ãããã®ã¯ã©ã¹ã¯ãXML-RPC ã§ä½¿ç¨ããå¤ã®ä½æã¨ã«ãã»ã«åãå¯è½ã«ãã¾ãã </para> <para> äºåã« <ulink url="&url.xmlrpc.spec;">&url.xmlrpc.spec;</ulink> 㧠XML-RPC ã®ä»æ§ãèªãã§ããã¨ããã以éã®å 容ãç解ãããããªãã§ãããã </para> <para> <classname>XML_RPC_Value</classname> ã¯ã©ã¹ã¯ã以ä¸ã®åãå©ç¨ã㦠任æã®è¤éãªå¤ãæ ¼ç´ãããã¨ãå¯è½ã§ãã <literal>i4</literal>ã <literal>int</literal>ã <literal>boolean</literal>ã <literal>string</literal>ã <literal>double</literal>ã <literal>dateTime.iso8601</literal>ã <literal>base64</literal>ã <literal>array</literal> ããã㯠<literal>struct</literal>ã ãããã®åã«ã¤ãã¦ã®è©³ç´°ãªæ å ±ã¯ <ulink url="&url.xmlrpc.spec;">ä»æ§</ulink> ãåç §ãã ããã </para> <refsect2> <title>åã«ã¤ãã¦ã®æ³¨æ</title> <refsect3> <title>int</title> <para> <classname>i4</classname> å㯠<classname>int</classname> ã®å¥åã§ããã³ã¼ãä¸ã§å¤ã解æããéã«ã¯ èªåçã« <classname>i4</classname> ã <classname>int</classname> ã«å¤æããã¾ãããã®å®è£ ã§ã¯ã<classname>int</classname> ã®ã»ãã æ£å¼åã¨ã¿ãªãã¦ãã¾ãã </para> </refsect3> <refsect3> <title>base64</title> <para> ãã®åã使ç¨ããã¨ãBase64 ã¨ã³ã³ã¼ãã£ã³ã°ãééçã«è¡ããã¾ãã ãã®ãããããã¯ãã¤ããªãã¼ã¿åã¨ãã¦æ±ãã¹ãã§ã7 ãããã¯ãªã¼ã³ ã§ã¯ãªããã¼ã¿ã渡ãããå ´åã«ä½¿ç¨ãã¾ãããã³ã¼ãå¦çãã¾ã ééçã«è¡ããã¾ãã </para> </refsect3> <refsect3> <title>boolean</title> <para> <literal>true</literal> ããã³ <literal>1</literal> 㯠<literal>true</literal> ã«ãããããã¾ãããã以å¤ã®ãã¹ã¦ã®å¤ ï¼ç©ºæååãå«ãï¼ã¯ <literal>false</literal> ã«å¤æããã¾ãã </para> </refsect3> <refsect3> <title>string</title> <para> <literal><</literal>ã <literal>></literal>ã <literal>"</literal> ããã³ <literal>&</literal> ã®åæåã¯ã XML-RPC ã§ã®éä¿¡ã®éã«åã ã¨ç価ãªã¨ã³ãã£ã㣠<literal>&lt;</literal>ã <literal>&gt;</literal>ã <literal>&quot;</literal> ããã³ <literal>&amp;</literal> ã«å¤æããã¾ããç¾å¨ã® XML-RPC ã®ä»æ§ã§ã¯ ã¨ã³ã³ã¼ãããããæ¨å¥¨ããã¦ããã®ã¯ <literal><</literal> ããã³ <literal>&</literal> ã ãã§ããããã®å®è£ ã§ã¯ããã«ä¸æ©å ãè¡ã£ã¦ãã¾ãã ãã®çç±ã¯ <ulink url="&url.w3.xml.rec;">XML 1.0 å§å</ulink> ã§èª¬æããã¦ãã¾ãã </para> <para> TODO: <literal>&apos;</literal> ã¨ã³ãã£ãã£ã¯ç¾å¨ãµãã¼ãããã¦ãã¾ããã </para> </refsect3> </refsect2> <refsect2 id="package.webservices.xml-rpc.api.value.creation" xreflabel="XML_RPC_Value constructors"> <title>çæ</title> <para> ã³ã³ã¹ãã©ã¯ã¿ã¯ã<classname>XML_RPC_Value</classname> ãçæããããã®ä¸è¬çãªæ¹æ³ã§ããã³ã³ã¹ãã©ã¯ã¿ã¯ä»¥ä¸ã®ãããªæ§æã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef></paramdef> </funcprototype> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef><parameter>$stringVal</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef><parameter>$scalarVal</parameter></paramdef> <paramdef><parameter>'int' | 'boolean' | 'string' | 'double' | 'dateTime.iso8601' | 'base64'</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef><parameter>$arrayVal</parameter></paramdef> <paramdef><parameter>'array' | 'struct'</parameter></paramdef> </funcprototype> </funcsynopsis> <para> æåã®ã³ã³ã¹ãã©ã¯ã¿ã¯ç©ºã®å¤ãçæãã¾ãã使ç¨ããåã«ãå¿ ã <function>addScalar</function>ã <function>addArray</function> ããã㯠<function>addStruct</function> ã§åæåããªããã°ãªãã¾ããã </para> <para> 2 çªç®ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ã·ã³ãã«ãªæååå¤ãçæãã¾ãã </para> <para> 3 çªç®ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ã¹ã«ã©å¤ãçæããããã«ä½¿ç¨ããã¾ãã 第 2 ãã©ã¡ã¼ã¿ã¯ã以ä¸ã®ä¾ã®ããã« XML-RPC åã®ååã§ããå¿ è¦ãããã¾ãã </para> <programlisting role="php"> <![CDATA[ $myInt = new XML_RPC_Value(1267, "int"); $myString= new XML_RPC_Value("Hello, World!", "string"); $myBool = new XML_RPC_Value(1, "boolean"); ]]> </programlisting> <para> 4 çªç®ã®å½¢å¼ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ãè¤é㪠XML-RPC ã®å¤ãä½æããã®ã« 使ç¨ããã¾ããå¤ã XML-RPC ã® <classname>é å</classname> ã§ããå ´å㯠åç´ãªé åã<classname>æ§é ä½</classname> ã®å ´åã¯é£æ³é åã 第 1 ãã©ã¡ã¼ã¿ã«æå®ãã¾ããé åã®è¦ç´ 㯠<emphasis> <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã§ããå¿ è¦ãããã¾ã </emphasis>ãä¾ãã°ä»¥ä¸ã®ããã«ãªãã¾ãã </para> <programlisting> <![CDATA[ $myArray = new XML_RPC_Value(array( new XML_RPC_Value("Tom"), new XML_RPC_Value("Dick"), new XML_RPC_Value("Harry")), "array"); $myStruct = new XML_RPC_Value(array( "name" => new XML_RPC_Value("Tom"), "age" => new XML_RPC_Value(34, "int"), "geek" => new XML_RPC_Value(1, "boolean")), "struct"); ]]> </programlisting> </refsect2> <refsect2 id="package.webservices.xml-rpc.api.value.methods" xreflabel="XML_RPC_Value methods"> <title>ã¡ã½ãã</title> <refsect3> <title><function>addScalar</function></title> <funcsynopsis> <funcprototype> <funcdef>$ok = $val->addScalar</funcdef> <paramdef><parameter>$stringVal</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$ok = $val->addScalar</funcdef> <paramdef><parameter>$scalarVal</parameter></paramdef> <paramdef><parameter>'int' | 'boolean' | 'string' | 'double' | 'dateTime.iso8601' | 'base64'</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã空㮠<classname>XML_RPC_Value</classname> ã ã£ãå ´åããã®ã¡ã½ãã㯠ããã«ã¹ã«ã©å¤ãè¨å®ãã¾ãããã§ã« <parameter>$val</parameter> ã« ã¹ã«ã©å¤ãè¨å®ããã¦ããå ´åãæ°ãã«ã¹ã«ã©å¤ã追å ããããã¨ã¯ãªã <literal>0</literal> ãè¿ããã¾ãããã¹ã¦ã®å¦çããã¾ãçµäºããå ´å㯠<literal>1</literal> ãè¿ããã¾ãã </para> <para> <parameter>$val</parameter> ã <classname>é å</classname> ã ã£ãå ´åã¯ç¹å¥ã§ãã¹ã«ã©å¤ãé åã«è¿½å ããã¾ãã </para> </refsect3> <refsect3> <title><function>addArray</function></title> <funcsynopsis> <funcprototype> <funcdef>$ok = $val->addArray</funcdef> <paramdef><parameter>$arrayVal</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 空㮠<classname>XML_RPC_Value</classname> ãã <parameter>$arrayVal</parameter> ã§æå®ããå 容㮠<classname>é å</classname> ã«å¤æãã¾ãã詳細ãªæ å ±ã¯ã4 çªç®ã® ã³ã³ã¹ãã©ã¯ã¿ã®æ¸å¼ãåç §ãã ããã </para> </refsect3> <refsect3> <title><function>addStruct</function></title> <funcsynopsis> <funcprototype> <funcdef>$ok = $val->addArray</funcdef> <paramdef><parameter>$assocArrayVal</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 空㮠<classname>XML_RPC_Value</classname> ãã <parameter>$assocArrayVal</parameter> ã§æå®ããå 容㮠<classname>æ§é ä½</classname> ã«å¤æãã¾ãã詳細ãªæ å ±ã¯ã4 çªç®ã® ã³ã³ã¹ãã©ã¯ã¿ã®æ¸å¼ãåç §ãã ããã </para> </refsect3> <refsect3> <title><function>kindOf</function></title> <funcsynopsis> <funcprototype> <funcdef>$kind = $val->kindOf</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> å¤ã®åã表ãæåå <literal>struct</literal>ã<literal>array</literal> ããã㯠<literal>scalar</literal> ãè¿ãã¾ããããå¤ã ã¾ã åæåããã¦ããªãå ´å㯠<literal>undef</literal> ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>serialize</function></title> <funcsynopsis> <funcprototype> <funcdef>$outString = $val->serialize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> å¤ããXML-RPC å½¢å¼ã®æååã§è¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>scalarval</function></title> <funcsynopsis> <funcprototype> <funcdef>$scalarVal = $val->scalarval</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <function>$val->kindOf</function> == 'scalar' ã®å ´åã ãã®ã¡ã½ãã㯠PHP è¨èªã®ã¹ã«ã©å¤ãè¿ãã¾ãï¼Base64 ãã³ã¼ãå¦çã¯èªåçã«è¡ããã¾ãï¼ã </para> </refsect3> <refsect3> <title><function>scalartyp</function></title> <funcsynopsis> <funcprototype> <funcdef>$typeName = $val->scalartyp</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <function>$val->kindOf</function> == 'scalar' ã®å ´åã ãã®ã¡ã½ããã¯ã¹ã«ã©ã®åã表ãæååãè¿ãã¾ããå ã«è¿°ã¹ãã¨ããã <literal>i4</literal> ã¯å¸¸ã« <literal>int</literal> ã«å¤æããã¾ãã </para> </refsect3> <refsect3> <title><function>arraymem</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $val->arraymem</funcdef> <paramdef><parameter>$n</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã§è¡¨ãããé åããã <parameter>$n</parameter> çªç®ã®è¦ç´ ãè¿ãã¾ãã è¿ãããå¤ã¯ <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã§ãã </para> </refsect3> <refsect3> <title><function>arraysize</function></title> <funcsynopsis> <funcprototype> <funcdef>$len = $val->arraysize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã <classname>array</classname> ã®å ´åããã®é åã®è¦ç´ æ°ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>structmem</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $val->structmem</funcdef> <paramdef><parameter>$memberName</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã§è¡¨ãããæ§é ä½ããã <parameter>$memberName</parameter> ã«å¯¾å¿ããè¦ç´ ãè¿ãã¾ãã è¿ãããå¤ã¯ <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã§ãã </para> </refsect3> <refsect3> <title><function>structeach</function></title> <funcsynopsis> <funcprototype> <funcdef>list($key,$value) = $val->structeach</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ãæ§é ä½ã®å ´åã«ã次㮠ããã¼ã»å¤ãã®çµã¿åãããè¿ãã¾ãã<xref linkend="package.webservices.xml-rpc.api.value.methods.structreset" /> ãåç §ãã ããã </para> </refsect3> <refsect3 id="package.webservices.xml-rpc.api.value.methods.structreset" xreflabel="structreset()"> <title><function>structreset</function></title> <funcsynopsis> <funcprototype> <funcdef>$val->structreset</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã§è¡¨ãããæ§é ä½ã«ã¤ãã¦ã <function>structeach</function> ã®å é¨ãã¤ã³ã¿ãæ§é ä½ã®å é ã«æ»ãã¾ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.server" xreflabel="XML_RPC_Server"> <title>XML_RPC_Server</title> <para> ãã®ã¯ã©ã¹ã®ç¾å¨ã®å®è£ ã¯ãã§ããéãã·ã³ãã«ã§ãããã¨ãå¿ããã¦ãã¾ãã åºæ¬çã«ã¯ãã³ã³ã¹ãã©ã¯ã¿ããã¹ã¦ã®ä»äºãããªãã¾ããæä½éã®ä¾ã¯ 以ä¸ã®ã¨ããã§ãã </para> <programlisting role="php"> <![CDATA[ function foo ($params) { ... } $s = new XML_RPC_Server(array("examples.myFunc" => array("function" => "foo"))); ]]> </programlisting> <para> ããã¯ããµã¼ãã§å®è¡ããããä»äºããã¹ã¦è¡ã£ã¦ããã¾ãããã£ãã²ã¨ã¤ã® å¼æ°ã¯é£æ³é åã§ãããã¡ã½ããåã¨é¢æ°åã対å¿ããã¾ãããªã¯ã¨ã¹ãã 解æãããã¨é©åãªé¢æ°ãå¼ã³åºãããé¢æ°ãè¿ã <classname>XML_RPC_Response</classname> ãªãã¸ã§ã¯ãã¯ã·ãªã¢ã©ã¤ãºãã㦠ã³ã¼ã«å ã«è¿ããã¾ãã </para> <para> ãã³ãã©é¢æ° <function>foo</function> ãä½ãè¡ãã®ãã«ã¤ãã¦ã ããããã詳ããè¦ã¦ã¿ã¾ãããã </para> <programlisting role="php"> <![CDATA[ function foo ($params) { global $XML_RPC_erruser; // ã¦ã¼ã¶ã¨ã©ã¼ã³ã¼ãã®å¤ãã¤ã³ãã¼ã // $params ã¯ãåä¿¡ãã XML_RPC_Message ãªãã¸ã§ã¯ã if ($err) { // ã¨ã©ã¼ãçºçããå ´å return new XML_RPC_Response(0, $XML_RPC_erruser+1, // ã¦ã¼ã¶ã¨ã©ã¼ 1 "è¦é·ãåé¡ãçºçãã¾ããã"); } else { // å¦çãæåããéã«è¿ãå¤ return new XML_RPC_Response(new XML_RPC_Value("ä¸äºé 調!", "string")); } } ]]> </programlisting> <refsect2> <title>ãã£ã¹ãããããã</title> <para> <function>XML_RPC_Server</function> ã³ã³ã¹ãã©ã¯ã¿ã®æåã®å¼æ°ã¯é åã§ã <emphasis>ãã£ã¹ãããããã</emphasis>ã¨å¼ã°ãã¾ãããã®é åã®ä¸ã«ããã®ã¯ã ããªããå®ç¾©ãã XML-RPC ã¡ã½ãããæä¾ããããã«å¿ è¦ãªæ å ±ã§ãã </para> <para> ãã£ã¹ããããããã¯ãé£æ³é åã®é£æ³é åã¨ããå½¢å¼ã«ãªãã¾ãã å¤å´ã®é åã¯åã ã®ã¡ã½ããã«å¯¾ãã¦ã²ã¨ã¤ã®ã¨ã³ããªãæã¡ã ã¡ã½ããåãé£æ³é åã®ãã¼ã¨ãªãã¾ãããã¼ã«å¯¾å¿ããå¤ã¯å¥ã®é£æ³é åã§ã 以ä¸ã®ãããªã¡ã³ããä¿æãã¾ãã </para> <itemizedlist> <listitem> <para> <parameter>function</parameter> - ãã®ã¨ã³ããªã¯å¿ é ã§ãã XML-RPC ã¡ã½ãããæä¾ããããã«ä½¿ç¨ããã°ãã¼ãã«ã¹ã³ã¼ãã®é¢æ°åã§ãã å¿ è¦ãããã¾ãã </para> </listitem> <listitem> <para> <parameter>signature</parameter> - ãã®ã¨ã³ããªã¯ãã¡ã½ãããã¨ããã ã·ã°ããã£ï¼<xref linkend="package.webservices.xml-rpc.api.server.signatures" /> ãåç §ãã ããï¼ãå«ãé åã§ãããã®ã¨ã³ããªãåå¨ããå ´åã ã¡ã½ãããå²ãæ¯ãåã«ãµã¼ãå´ã§å¼æ°ã®æ°ãåã®ãã§ãã¯ãè¡ãã¾ãã </para> </listitem> <listitem> <para> <parameter>docstring</parameter> - ãã®ã¨ã³ããªã¯ãã¡ã½ããã® ããã¥ã¡ã³ããå«ãæååã§ããããã¥ã¡ã³ãã«ã¯ HTML ãã¼ã¯ã¢ããã å«ãããã¨ãå¯è½ã§ãã </para> </listitem> </itemizedlist> </refsect2> <refsect2 id="package.webservices.xml-rpc.api.server.signatures" xreflabel="Signatures"> <title>ã¡ã½ããã®ã·ã°ããã£</title> <para> ã·ã°ããã£ã¨ã¯ãã¡ã½ããã®è¿ãå¤ã®åããã®ãã©ã¡ã¼ã¿ã®åã示ããã®ã§ãã ã¡ã½ããã¯ããããªãã¨ãã²ã¨ã¤ã®ã·ã°ããã£ãæã£ã¦ãã¾ãã </para> <para> ãµã¼ãã®ãã£ã¹ããããããå ã§ã¯ãåã ã®ã¡ã½ããã¯ã¨ãããã·ã°ããã£ã® é åãä¿æãã¦ãã¾ããåã·ã°ããã£ã®ä¸èº«ã¯åã®é åã§ãæåã®ã¨ã³ããªã¯ è¿ãå¤ã®åã§ãã </para> <para> ä¾ãå®è¡ãã¦ã¿ã¾ãããããã®ãããªæ®éã® PHP é¢æ°ãæ¸ããã¨ãã¦ããç¶æ³ã æ³å®ãã¦ãã ããã <programlisting role="php"> <![CDATA[ function is_8($input, $strict = false) { if ($strict) { return ($input === 8); } else { return ($input == 8); } } ]]> </programlisting> </para> <para> ãã®é¢æ°ã XML_RPC ãµã¼ãã§åä½ããããã¨ããã¨ããã®ããã« æ¸ãå¿ è¦ãããã¾ãã <programlisting role="php"> <![CDATA[ function is_8($params) { // ãã®ãã©ã¡ã¼ã¿ã¯å¿ é $param = $params->getParam(0); if (!XML_RPC_Value::isValue($param)) { return $param; } $input = $param->scalarval(); // ãã®ãã©ã¡ã¼ã¿ã¯ãªãã·ã§ã³ $param = $params->getParam(1); if (!XML_RPC_Value::isValue($param)) { $strict = false; } else { $strict = $param->scalarval(); } if ($strict) { $answer = ($input === 8); } else { $answer = ($input == 8); } $val = new XML_RPC_Value($answer, 'boolean'); return new XML_RPC_Response($val); } ]]> </programlisting> </para> <para> ããã¯ãã¨ãããé çªã®ã·ã°ããã£ããã¹ã¦ç¶²ç¾ ãããã®ã§ãã <programlisting role="php"> <![CDATA[ array( array('boolean', 'int'), array('boolean', 'int', 'boolean'), array('boolean', 'string'), array('boolean', 'string', 'boolean'), ) ]]> </programlisting> </para> <para> ãµã¼ãã¯ãã®ããã«ãã¦ã¤ã³ã¹ã¿ã³ã¹åãã¾ãã <programlisting role="php"> <![CDATA[ $server = new XML_RPC_Server( array( 'isan8' => array( 'function' => 'is_8', 'signature' => array( array('boolean', 'int'), array('boolean', 'int', 'boolean'), array('boolean', 'string'), array('boolean', 'string', 'boolean'), ), 'docstring' => 'å¤ã¯ 8 ã§ãã?' ), ), 1, 0 ); ]]> </programlisting> </para> <para> 使ãããããèæ ®ããXML-RPC ã®åã表ãæååãã°ãã¼ãã«å¤æ°ã¨ã㦠ã³ã¼ãåããã¦ãã¾ãã </para> <programlisting role="php"> <![CDATA[ $XML_RPC_I4 = 'i4'; $XML_RPC_Int = 'int'; $XML_RPC_Boolean = 'boolean'; $XML_RPC_Double = 'double'; $XML_RPC_String = 'string'; $XML_RPC_DateTime = 'dateTime.iso8601'; $XML_RPC_Base64 = 'base64'; $XML_RPC_Array = 'array'; $XML_RPC_Struct = 'struct'; ]]> </programlisting> </refsect2> <refsect2> <title>ãµã¼ãããã®å¿çã®é 延</title> <para> ããªããä½ããã¨ãã¦ãããµã¼ãã§ã¯ãä½ããã®çç±ï¼ãã¨ãã° ã»ãã¥ãªãã£èªè¨¼ãªã©ï¼ã«ãããªã¯ã¨ã¹ãã«å¯¾ããå¿çããã£ããä¿çããã ãã¨ãããã§ããããã³ã³ã¹ãã©ã¯ã¿ã® 2 çªç®ã®å¼æ°ã« <literal>0</literal> ã渡ãã¨ããæã¿ã®å¹æãå¾ããã¾ãããã®å¾ã ãµã¼ãã¯ã©ã¹ã® <function>service</function> ã¡ã½ããã使ç¨ã㦠ãªã¯ã¨ã¹ããå¦çããã°ããã®ã§ãããã¨ãã°ä»¥ä¸ã®ããã«ãªãã¾ãã </para> <programlisting role="php"> <![CDATA[ $s = new XML_RPC_Server($myDispMap, 0); // ... ä½ããã®ä»ã®å¦çãããã§è¡ã $s->service(); ]]> </programlisting> </refsect2> <refsect2> <title>失æã®å ±å</title> <para> ãµã¼ããè¿ã失æã³ã¼ãã¯ãã°ãã¼ãã«ã® <literal>$xmlrpcerruser</literal> ãæãå¤ã« 1 ãå ããå¤ããéå§ããã¹ãã§ãã </para> <para> ãµã¼ããè¿ãæ¨æºçãªã¨ã©ã¼ã«ã¯ä»¥ä¸ã®ãããªãã®ãããã¾ãã </para> <variablelist> <varlistentry> <term> <literal>1</literal> <phrase>Unknown method</phrase> </term> <listitem> <para> ãµã¼ããé¢ç¥ããªãã¡ã½ããã®å®è¡ãè¦æ±ãããéã«è¿ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>2</literal> <phrase>Invalid return payload</phrase> </term> <listitem> <para> ãã®ã¨ã©ã¼ã¯ãå®éã®ã¨ãããµã¼ããã³ã¼ãã§ã¯ãªãã¯ã©ã¤ã¢ã³ãå´ã§ çºçãã¾ããããããããã¯ãµã¼ããèªåã§ç解ã§ããªãä½ããè¿ãããã¨ã 示ãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>3</literal> <phrase>Incorrect parameters</phrase> </term> <listitem> <para> ãµã¼ããã¡ã½ããã«å¯¾å¿ããã·ã°ããã£ãä¿æãã¦ãããã¯ã©ã¤ã¢ã³ããã 渡ããããã©ã¡ã¼ã¿ããããã®ã·ã°ããã£ã«ãä¸è´ããªãã£ãéã«çºçãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>4</literal> <phrase>Can't introspect: method unknown</phrase> </term> <listitem> <para> ãã®ã¨ã©ã¼ã¯ãçµã¿è¾¼ã¿ã® <function>system.*</function> ã¡ã½ãããã çºçãããã®ã§ããµã¼ãä¸ã§æªå®ç¾©ã®ã¡ã½ãããå®è¡ãããã¨ããéã«èµ·ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>5</literal> <phrase>Didn't receive 200 OK from remote server</phrase> </term> <listitem> <para> ãã®ã¨ã©ã¼ã¯ããµã¼ãããã®å¿çã¨ã㦠HTTP/1.1 200 OK ãæ»ã£ã¦ããªãã£ãéã« ã¯ã©ã¤ã¢ã³ãå´ã§çºçãã¾ããã¨ã©ã¼ã®è©³ç´°ãªæ å ±ã¯ãä¸ã®ã¡ãã»ã¼ã¸ã®æå¾ã« ä»ãå ãããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>100-</literal> <phrase>XML parse errors</phrase> </term> <listitem> <para> çºçããé害㮠XML ãã¼ãµã¨ã©ã¼ã³ã¼ãã« 100 ãå ãããã®ãè¿ãã¾ãã è¿ããã <varname>faultString</varname> ã®ä¸ã«ã¯ãå ¥å XML ã¹ããªã¼ã ã® ã©ãã§ãã¼ã¹ã¨ã©ã¼ãçºçããã®ãã示ããã¦ãã¾ãã </para> </listitem> </varlistentry> </variablelist> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.dump" xreflabel="XML_RPC_Dump"> <title>XML_RPC_Dump</title> <para> ãã®ã¯ã©ã¹ã¯ãXML_RPC_Value ãªãã¸ã§ã¯ãå ã®ãã¼ã¿ã® æåå表ç¾ãçæãã¾ãã </para> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.other" xreflabel="other"> <title>ãã®ä»ã®é¢æ°</title> <para> 以ä¸ã¯ XML_RPC ãªãã¸ã§ã¯ãã®å¤é¨ã«ããé¢æ°ã§ãã </para> <refsect2> <title><function>XML_RPC_encode</function></title> <funcsynopsis> <funcprototype> <funcdef>$rpc = XML_RPC_encode</funcdef> <paramdef><parameter>$php_val</parameter></paramdef> </funcprototype> </funcsynopsis> <para> PHP ã®ãã¤ãã£ããã¼ã¿åãåãåããããã XML_RPC ãªãã¸ã§ã¯ãåã« å¤æãã¾ãã </para> </refsect2> <refsect2> <title><function>XML_RPC_decode</function></title> <funcsynopsis> <funcprototype> <funcdef>$values = XML_RPC_decode</funcdef> <paramdef><parameter>$XML_RPC_val</parameter></paramdef> </funcprototype> </funcsynopsis> <para> XML_RPC ãªãã¸ã§ã¯ãåã®ã¡ãã»ã¼ã¸ãåãåããããã PHP ã® ãã¤ãã£ããã¼ã¿åã«å¤æãã¾ãã </para> </refsect2> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/examples.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/examples.xml +++ peardoc/ja/package/webservices/xml-rpc/examples.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.7 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.examples"> <refnamediv> <refname>ä¾</refname> <refpurpose>XML_RPC ããã±ã¼ã¸ã®å©ç¨ä¾</refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.examples.latest"> <title> ã¯ã©ã¤ã¢ã³ãã使ç¨ãã¦ãPEAR ã®ææ°æ å ±ãåå¾ãã </title> <example> <title /> <programlisting role="php"> <![CDATA[ require_once 'XML/RPC.php'; /* * ãã¡ã°ãæè¿ã«ãªãªã¼ã¹ããã PEAR ããã±ã¼ã¸ã®æ å ±ãåå¾ãã */ $params = array(new XML_RPC_Value(1, 'int')); $msg = new XML_RPC_Message('release.getRecent', $params); $cli = new XML_RPC_Client('/xmlrpc.php', 'pear.php.net'); // $cli->setDebug(1); $resp = $cli->send($msg); if (!$resp) { echo 'Communication error: ' . $cli->errstr; exit; } if (!$resp->faultCode()) { $val = $resp->value(); $data = XML_RPC_decode($val); echo $data[0]['name'] . ' is at version ' . $data[0]['version']; } else { /* * xmlrpc.php ã¹ã¯ãªãããééããåé¡ã * å ±åãã */ echo 'Fault Code: ' . $resp->faultCode() . "\n"; echo 'Fault Reason: ' . $resp->faultString() . "\n"; } ]]> </programlisting> </example> </refsect1> <refsect1 id="package.webservices.xml-rpc.examples.complete"> <title>ã¯ã©ã¤ã¢ã³ã - ãµã¼ã ã®çµã¿åãã</title> <example> <title /> <para> ããããµã¼ãå´ã®ã¹ã¯ãªããã§ããlocalhost ã® web ãµã¼ãã® ããã¥ã¡ã³ãã«ã¼ãã«ãxmlrpc.php ã¨ããååã§è¨ç½®ãã¾ãã </para> <programlisting role="php"> <![CDATA[ require_once 'XML/RPC/Server.php'; function returnTimes2($params) { $param = $params->getParam(0); // ãã®ã¨ã©ã¼ãã§ãã¯æ§æã¯ããªãªã¼ã¹ 1.3.0 ã§è¿½å ããã¾ãã if (!XML_RPC_Value::isValue($param)) { return $param; } $val = new XML_RPC_Value($param->scalarval() * 2, 'int'); return new XML_RPC_Response($val); } $server = new XML_RPC_Server( array( 'times2' => array( 'function' => 'returnTimes2' ) ) ); ]]> </programlisting> <para> ããã¦ãã¡ããã¯ã©ã¤ã¢ã³ãå´ã®ã¹ã¯ãªããã§ãã </para> <programlisting role="php"> <![CDATA[ require_once 'XML/RPC.php'; $input = 8; $params = array(new XML_RPC_Value($input, 'int')); $msg = new XML_RPC_Message('times2', $params); $cli = new XML_RPC_Client('/xmlrpc.php', 'localhost'); // $cli->setDebug(1); $resp = $cli->send($msg); if (!$resp) { echo 'Communication error: ' . $cli->errstr; exit; } if (!$resp->faultCode()) { $val = $resp->value(); echo $input . ' times 2 is ' . $val->scalarval(); } else { /* * xmlrpc.php ã¹ã¯ãªãããééããåé¡ã * å ±åãã */ echo 'Fault Code: ' . $resp->faultCode() . "\n"; echo 'Fault Reason: ' . $resp->faultString() . "\n"; } ]]> </programlisting> </example> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/intro.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/intro.xml +++ peardoc/ja/package/webservices/xml-rpc/intro.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.intro"> <refnamediv> <refname>å°å ¥</refname> <refpurpose></refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.intro.general"> <title>æ¦è¦ã®ç´¹ä»</title> <para> XML-RPC ã¯ãXML ãç¨ãããªã¢ã¼ãããã·ã¼ã¸ã£ã³ã¼ã«ãå®ç¾ããããã« <ulink url="&url.userland;">Userland Software</ulink> ãèæ¡ãã ãã©ã¼ãããã§ããXML-RPC ã® web ãµã¤ã㯠<ulink url="&url.xmlrpc;">www.XmlRpc.com</ulink> ã§ãã </para> <para> ç¾æç¹ã§ä½¿ç¨å¯è½ãª XML-RPC ã®å®è£ ã®ã»ã¨ãã©ã¯ããã¼ã¿äº¤æã« HTTP ã使ç¨ãã¦ãã¾ããPerl ã Python ãªã©ä»ã®è¨èªã§ã®å®è£ ã®ä¸è¦§ã <ulink url="&url.xmlrpc;">www.xmlrpc.com</ulink> ã«ããã¾ãã </para> <para> ãã® PHP ã¯ã©ã¹ç¾¤ã¯ãXML-RPC ã®ã¯ã©ã¤ã¢ã³ãããã³ãµã¼ãã PHP 㧠è¨è¿°ããããã®ãã¬ã¼ã ã¯ã¼ã¯ãæä¾ãã¾ãã </para> </refsect1> <refsect1 id="package.webservices.xml-rpc.intro.acknowledgements"> <title>è¬è¾</title> <para> ãã®ããã±ã¼ã¸ã¯ãUseful Information Company ã® <ulink url="&url.usefulinc;">Edd Dumbill</ulink> ã«ãã£ã¦æåã«æ¸ããã¾ããã æãè³è³ãããã¹ããªã®ã¯å½¼ã§ããæåã®ã³ã¼ããã¼ã¹ã«å¯¾ãã¦è²¢ç®ãã 以ä¸ã®äººã ã¯å¥ã¨ãã¦ããã®ã³ã¼ãã¯ç¾å¨ã Edd ã«ãã£ã¦ä¿å®ããã¦ãã¾ãã </para> <itemizedlist> <listitem> <para>Jim Winstead <email>jimw at php dot net</email></para> </listitem> <listitem> <para>Peter Kocks <email>peter.kocks at baygate dot com</email></para> </listitem> <listitem> <para>Nicolay Mausz <email>mausz at flying-dog dot com</email></para> </listitem> <listitem> <para>Ben Margolin <email>ben at wendy.auctionwatch dot com</email></para> </listitem> <listitem> <para>Dan Libby <email>dan at libby dot com</email></para> </listitem> <listitem> <para>Gaetano Giunta <email>g.giunta at libero dot it</email></para> </listitem> <listitem> <para>Idan Sofer <email>i_sofer at yahoo dot com</email></para> </listitem> <listitem> <para>Giancarlo Pinerolo <email>ping at alt dot it</email></para> </listitem> <listitem> <para>Justin Miller <email>justin at voxel dot net</email></para> </listitem> </itemizedlist> </refsect1> <refsect1 id="package.webservices.xml-rpc.intro.manifest"> <title>ãã¡ã¤ã«ä¸è¦§ - ããã±ã¼ã¸å ã®ãã¡ã¤ã«</title> <titleabbrev>ãã¡ã¤ã«ä¸è¦§</titleabbrev> <glosslist> <glossentry> <glossterm>Server.php</glossterm> <glossdef> <para> XML-RPC ãµã¼ãã¯ã©ã¹ããµã¼ãæ©è½ã使ç¨ããããããã«ãããã <function>include</function> ãã¾ãã </para> </glossdef> </glossentry> <glossentry> <glossterm>RPC.php</glossterm> <glossdef> <para> XML-RPC ã¯ã©ã¤ã¢ã³ãã¯ã©ã¹ãã¯ã©ã¤ã¢ã³ãæ©è½ã使ç¨ããããã«ãããã <function>include</function> ãã¾ãã </para> </glossdef> </glossentry> </glosslist> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/support.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/support.xml +++ peardoc/ja/package/webservices/xml-rpc/support.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.support"> <refnamediv> <refname>ãµãã¼ã</refname> <refpurpose>XML_RPC ã®ãµãã¼ããåããã«ã¯</refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.support.online"> <title>ãªã³ã©ã¤ã³ãµãã¼ã</title> <para> ãã®ããã±ã¼ã¸ã¯<quote>ãããã¾ã¾ï¼as-isï¼</quote>ã§æä¾ããã¦ããã ä½ããã®è£åãããããµãã¼ãã®ç´æãããããããã®ã§ã¯ããã¾ããã ããããPEAR ã¦ã¼ã¶ã¡ã¼ãªã³ã°ãªã¹ãã XML-RPC.com ã«ã¦ éå ¬å¼ãªã¢ããã¤ã¹ããã«ããè¡ã£ã¦ãã¾ãã </para> <itemizedlist> <listitem> <para> ããã±ã¼ã¸ã®ä½¿ç¨æ³ã«é¢ãã質åã¯ã <ulink url="mailto:&email.pear.general;">PEAR ã¦ã¼ã¶ã¡ã¼ãªã³ã°ãªã¹ã </ulink> ãéãã¦è¡ã£ã¦ãã ããã詳細㯠<ulink url="&url.pear.support;">ãã¡ããã覧ãã ãã</ulink>ã </para> </listitem> <listitem> <para> XML-RPC ã«ã¤ãã¦ã®ä¸è¬çãªè³ªåã«ã¯ãYahoo! ã°ã«ã¼ãã® <ulink url="&url.xmlrpc.list;">XML-RPC ã¡ã¼ãªã³ã°ãªã¹ã</ulink>ãå©ç¨ã§ãã¾ãã </para> </listitem> <listitem> <para> XML-RPC ã®ä½¿ç¨æ³ã«ã¤ãã¦ã®å©è¨ãå¾ãã«ã¯ã<ulink url="&url.xmlrpc.discuss;">XML-RPC.com</ulink> ã®æ²ç¤ºæ¿ã便å©ã§ãã ãã®æ²ç¤ºæ¿ã®å 容ã¯ãYahoo! Groups ã®ã¡ã¼ãªã³ã°ãªã¹ãã«ãåæ ããã¾ãã </para> </listitem> </itemizedlist> </refsect1> <refsect1 id="package.webservices.xml-rpc.support.jellyfish"> <title>ã¯ã©ã²æ¬</title> <para> <graphic fileref="http://www.oreilly.com/catalog/covers/progxmlrpc.s.gif" format="GIF" width="145" depth="190" align="right"></graphic> Simon St.Laurent ã Joe Johnston ã¨ã¨ãã« Edd Dumbill ãæ¸ãã XML-RPC ã«ã¤ãã¦ã®æ¬ããO'Reilly and Associates ããçºå£²ããã¦ãã¾ãã ãã®æ¬ã®è¡¨ç´ã«ã¯ãã¡ãã£ã¨ç®ãå¼ãã¯ã©ã²ãæããã¦ãã¾ãã </para> <para> ãã®æ¬ã«ã¤ãã¦ã®è©³ç´°ã¯ã<ulink url="&url.xmlrpc.book;">O'Reilly ã® web ãµã¤ãããå¾ããã¾ã</ulink>ã </para> <para> Edd 㯠PHP ã«é¢ããç« ãæ å½ãã¦ãããå®éã«åä½ããä¾ãåé²ããã¦ãã¾ãã ãã®å 容ã¯ãæ²ç¤ºæ¿ãµã¼ããç«ã¡ä¸ããO'Reilly ã® <ulink url="&url.meerkat;">Meerkat</ulink> ãµã¼ãã¹ãç¨ã㦠Web ä¸ã® ãã¥ã¼ã¹è¨äºã«å¯¾ããã³ã¡ã³ããè¡ããã®ã§ãã </para> <para> ããããã½ããã¦ã§ã¢ãæ¸ãä¸ããå½¼ã®å´åã®ãããã§ä½ããã®æ©æµãåãã ãªãããã²ãã®æ¬ãè³¼å ¥ãããã¨ãèãã¦ãã ããã </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/api.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/api.xml +++ peardoc/ja/package/webservices/xml-rpc/api.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.api"> <refnamediv> <refname>API</refname> <refpurpose>ããã±ã¼ã¸å ã®ã¯ã©ã¹ã®ããã¥ã¡ã³ã</refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.api.client"> <title>XML_RPC_Client</title> <para> ããã¯ãXML-RPC ãµã¼ãã®ã¯ã©ã¤ã¢ã³ãã表ç¾ããããã«ä½¿ç¨ããã¾ãã </para> <refsect2> <title>çæ</title> <para> ã³ã³ã¹ãã©ã¯ã¿ã¯ä»¥ä¸ã®ãããªæ§æã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$client = new XML_RPC_Client</funcdef> <paramdef> string <parameter>$path</parameter> </paramdef> <paramdef> string <parameter>$server</parameter> </paramdef> <paramdef> integer <parameter><optional>$port</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$proxy</optional></parameter> </paramdef> <paramdef> integer <parameter><optional>$proxy_port</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$proxy_user</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$proxy_pass</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <variablelist> <varlistentry> <term> &type.string; <parameter>$path</parameter> </term> <listitem> <para> ãªã¯ã¨ã¹ããéä¿¡ããã RPC ãµã¼ãã¹ã¯ãªããã®ãã¹ã¨ååã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$server</parameter> </term> <listitem> <para> æ¥ç¶å ãªã¢ã¼ããµã¼ãã® URL ããããã³ã«ãæå®ããã¦ãããã ã㤠$port ã 443 ã§ãã£ãå ´å㯠ssl:// ã使ç¨ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.int; <parameter>$port</parameter> </term> <listitem> <para> ãªã¢ã¼ããµã¼ãã«æ¥ç¶ããéã®ãã¼ããããã©ã«ã㯠80 ã§ã http:// æ¥ç¶ã表ãã¾ãã443 ãæå®ãã㨠https:// ããã³ ssl:// æ¥ç¶ã¨ãªãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$proxy</parameter> </term> <listitem> <para> ãã使ç¨ãããªãããããã·ãµã¼ãã® URL ã ãããã³ã«ãæå®ããã¦ãããã ã㤠$port ã 443 ã§ãã£ãå ´å㯠ssl:// ã使ç¨ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.int; <parameter>$proxy_port</parameter> </term> <listitem> <para> ãªã¢ã¼ããµã¼ãã«æ¥ç¶ããéã®ãã¼ããããã©ã«ã㯠8080 ã§ã http:// æ¥ç¶ã表ãã¾ãã443 ãæå®ãã㨠https:// ããã³ ssl:// æ¥ç¶ã¨ãªãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$proxy_user</parameter> </term> <listitem> <para> ãããã·ãµã¼ãã«ã¢ã¯ã»ã¹ããããã®ã¦ã¼ã¶åã </para> </listitem> </varlistentry> <varlistentry> <term> &type.string; <parameter>$proxy_pass</parameter> </term> <listitem> <para> ãããã·ãµã¼ãã«ã¢ã¯ã»ã¹ããããã®ãã¹ã¯ã¼ãã </para> </listitem> </varlistentry> </variablelist> </para> <para> <note> <para> SSL æ¥ç¶ã使ç¨ããã«ã¯ã <ulink url="http://php.net/openssl"> <literal>openssl</literal></ulink> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ã㦠PHP ãã¤ã³ã¹ãã¼ã«ããã¦ããå¿ è¦ãããã¾ãã </para> </note> </para> <para> <emphasis>betty.userland.com</emphasis> ã«ãã Userland ã® XML-RPC ãµã¼ãã«åãåãããããã®ã¯ã©ã¤ã¢ã³ãè¨å®ã®ä¾ã¯ ãã®ããã«ãªãã¾ãã </para> <programlisting role="php"> <![CDATA[ $client = new XML_RPC_Client('/RPC2', 'betty.userland.com'); ]]> </programlisting> </refsect2> <refsect2> <title>ã¡ã½ãã</title> <para> ãã®ã¯ã©ã¹ã¯ä»¥ä¸ã®ã¡ã½ããããµãã¼ããã¦ãã¾ãã </para> <refsect3> <title><function>send</function></title> <para> ãã®ã¡ã½ããã¯ä»¥ä¸ã®ãããªæ¸å¼ã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$response = $client->send</funcdef> <paramdef><parameter>$xmlrpc_message</parameter></paramdef> <paramdef><parameter><optional>$timeout</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$xmlrpc_message</parameter> 㯠<classname>XML_RPC_Message</classname> ã®ã¤ã³ã¹ã¿ã³ã¹ã§ã <parameter>$response</parameter> 㯠<classname>XML_RPC_Response</classname> ã®ã¤ã³ã¹ã¿ã³ã¹ã§ãï¼<xref linkend="package.webservices.xml-rpc.api.response" /> ãåç §ãã ããï¼ã </para> <para> <parameter>$timeout</parameter> ã¯ãªãã·ã§ã³ã§ãæå®ããªãã£ãå ´å㯠<literal>0</literal>ï¼æ°¸é ã«å¾ ã¡ç¶ããï¼ã¨ãªãã¾ãããã®å¤ã¯ <function>fsockopen</function> ã«æ¸¡ããã¾ãã </para> <para> ãã <parameter>$response</parameter> ã®å 容ã <classname>XML_RPC_Response</classname> ã§ã¯ãªã <literal>0</literal> ã§ãã£ãå ´åããã㯠I/O ã¨ã©ã¼ãçºçãããã¨ã 表ãã¾ããçºçãã I/O ã¨ã©ã¼ã®å 容ã«ã¤ãã¦ã¯ã <varname>$client->errno</varname> ããã³ <varname>$client->errstring</varname> ã®å¤ããç¥ããã¨ãã§ãã¾ãã </para> <para> ä½ã¬ãã«ã®ã¨ã©ã¼ã«å ããåãåããå ã® XML-RPC ãµã¼ãã <classname>XML_RPC_Response</classname> ãªãã¸ã§ã¯ãã®ä¸ã§ã¨ã©ã¼ã è¿ããã¨ãããã¾ãããããã®ã¨ã©ã¼ãå¦çããæ¹æ³ã«ã¤ãã¦ã¯ <xref linkend="package.webservices.xml-rpc.api.response" /> ãåç §ãã ããã </para> </refsect3> <refsect3> <title><function>setCredentials</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setCredentials</funcdef> <paramdef><parameter>$username</parameter></paramdef> <paramdef><parameter>$password</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã®ã¡ã½ããã¯ãã¯ã©ã¤ã¢ã³ãããµã¼ãã«å¯¾ããèªè¨¼å¦çãè¡ãéã® ã¦ã¼ã¶åã¨ãã¹ã¯ã¼ããæå®ãã¾ããããã©ã«ãã®éä¿¡ï¼HTTPï¼ã§ã¯ã ãããã®æ å ±ã HTTP ãã¼ã·ãã¯èªè¨¼ã«ä½¿ç¨ããã¾ãã </para> </refsect3> <refsect3> <title><function>setCertificate</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setCertificate</funcdef> <paramdef><parameter>$certificate</parameter></paramdef> <paramdef><parameter>$passphrase</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã®ã¡ã½ããã¯ããªã¢ã¼ããµã¼ãã¨ã® SSL éä¿¡ãè¡ãéã«ä½¿ç¨ããã ãªãã·ã§ã³ã®è¨¼ææ¸ã¨ãã¹ãã¬ã¼ãºãè¨å®ãã¾ãã </para> <para> <parameter>certificate</parameter> ãã©ã¡ã¼ã¿ã¯ãPEM ãã©ã¼ããã㮠証ææ¸ãã¡ã¤ã«åã§ããå¿ è¦ãããã¾ãã <parameter>passphrase</parameter> ãã©ã¡ã¼ã¿ã¯ããã®è¨¼ææ¸ã使ç¨ããããã« å¿ è¦ãªãã¹ã¯ã¼ããå«ãã§ããå¿ è¦ãããã¾ãã </para> <para> ããã使ç¨ããã«ã¯ãPHP ã®ã³ã³ãã¤ã«æã« <literal>openssl</literal> æ¡å¼µã¢ã¸ã¥ã¼ã«ãçµã¿è¾¼ãã§ããå¿ è¦ãããã¾ãã </para> </refsect3> <!-- methods don't exist (yet) <refsect3> <title><function>setSSLVerifyPeer</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setSSLVerifyPeer</funcdef> <paramdef><parameter>$i</parameter></paramdef> </funcprototype> </funcsynopsis> <para> This method defines whether connections made to XML-RPC backends via HTTPS should verify the remote host's SSL certificate, and cause the connection to fail if the cert verification fails. $i should be a boolean value. </para> </refsect3> <refsect3> <title><function>setSSLVerifyHost</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setSSLVerifyHost</funcdef> <paramdef><parameter>$i</parameter></paramdef> </funcprototype> </funcsynopsis> <para> This method defines whether connections made to XML-RPC backends via HTTPS should verify the remote host's SSL certificate's common name (CN). By default, only the existence of a CN is checked. $i should be an integer value; 0 to not check the CN at all, 1 to merely check for its existence, and 2 to check that the CN on the certificate matches the hostname that is being connected to. </para> </refsect3> --> <refsect3> <title><function>setDebug</function></title> <funcsynopsis> <funcprototype> <funcdef>$client->setDebug</funcdef> <paramdef><parameter>$debugOn</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$debugOn</parameter> 㯠<literal>0</literal> ããã㯠<literal>1</literal> ã®ã©ã¡ããã§ãã¯ã©ã¤ã¢ã³ãã®ãã©ã¦ã¶ã«ãããã°æ å ±ã 表示ãããå¦ããæå®ãã¾ããããã©ã«ãã§ã¯ãã®æ å ±ã表示ãã¾ããã </para> <para> ãããã°æ å ±ã®ä¸ã«ã¯ XML-RPC ãµã¼ããè¿ãåãåããçµæã®çãã¼ã¿ãå«ã¾ãã ã¾ããµã¼ãããè¿ãããå¤ã表ãããã«ã¯ã©ã¤ã¢ã³ããä½æãããã¨ãã PHP ã®å¤ãå«ã¾ãã¾ãããµã¼ããè¿ãå 容ãæ£ç¢ºã«ç¢ºèªãããã¨ãã§ããã®ã§ã ãã®ãªãã·ã§ã³ã¯ãµã¼ãã®ãããã°æã«æç¨ã§ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.message" xreflabel="XML_RPC_Message"> <title>XML_RPC_Message</title> <para> ãã®ã¯ã©ã¹ã¯ XML-RPC ãµã¼ãã¸ã®ãªã¯ã¨ã¹ãã表ãã¾ããã¯ã©ã¤ã¢ã³ã㯠<classname>XML_RPC_Message</classname> ããµã¼ãã«éä¿¡ãã <classname>XML_RPC_Response</classname> ãåãåãã¾ãã </para> <refsect2> <title>çæ</title> <para> ã³ã³ã¹ãã©ã¯ã¿ã¯ä»¥ä¸ã®ãããªæ§æã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$msg = new XML_RPC_Message</funcdef> <paramdef><parameter>$methodName</parameter></paramdef> <paramdef><parameter>$parameterArray</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$methodName</parameter> ã¯èµ·åãããã¡ã½ããã®ååã§ã <parameter>$parameterArray</parameter> 㯠<classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã®é åã§ãã <emphasis>US state name</emphasis> ãµã¼ãã«ã¡ãã»ã¼ã¸ãéä¿¡ããä¾ã§ãã </para> <programlisting role="php"> <![CDATA[ require_once "XML/RPC.php"; $msg = new XML_RPC_Message("examples.getStateName", array(new XML_RPC_Value(23, "int"))); ]]> </programlisting> <para> ãã®ä¾ã§ã¯å·çªå· 23 ã®å·ã®ååãåãåããã¦ãã¾ãã <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã«ã¤ãã¦ã® 詳細ãªæ å ±ã¯ <xref linkend="package.webservices.xml-rpc.api.value" /> ãåç §ãã ããã </para> </refsect2> <refsect2> <title>ã¡ã½ãã</title> <refsect3> <title><function>serialize</function></title> <funcsynopsis> <funcprototype> <funcdef>$outString = $msg->serialize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> XML-RPC ã¡ãã»ã¼ã¸ã表ã XML æååãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>addParam</function></title> <funcsynopsis> <funcprototype> <funcdef>$msg->addParam</funcdef> <paramdef><parameter>$xmlrpcVal</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã®ã¡ã½ããã®ã³ã¼ã«ã«ããããã©ã¡ã¼ã¿ãªã¹ãã« <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ã <parameter>$xmlrpcVal</parameter> ã追å ãã¾ãã </para> </refsect3> <refsect3> <title><function>getParam</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $msg->getParam</funcdef> <paramdef><parameter>$n</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ã¡ãã»ã¼ã¸ä¸ã® <parameter>$n</parameter> çªç®ã®ãã©ã¡ã¼ã¿ãåå¾ãã¾ãã ãã®ã¡ã½ããã使ç¨ã§ãããã©ããã¯ãµã¼ãã®å®è£ ã«ä¾åãã¾ãã ãããã©ã¡ã¼ã¿ãåå¨ããªãå ´å㯠<literal>undef</literal> ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>getNumParams</function></title> <funcsynopsis> <funcprototype> <funcdef>$n = $msg->getNumParams</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> ã¡ãã»ã¼ã¸ã«ä»å±ãããã©ã¡ã¼ã¿ã®æ°ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>method</function></title> <funcsynopsis> <funcprototype> <funcdef>$methName=$msg->method</funcdef> <paramdef></paramdef> </funcprototype> <funcprototype> <funcdef>$msg->method</funcdef> <paramdef><parameter>$methName</parameter></paramdef> </funcprototype> </funcsynopsis> <para> XML-RPC ã¡ãã»ã¼ã¸ä¸ã«å«ã¾ããã¡ã½ãããåå¾ãããã¯è¨å®ãã¾ãã </para> </refsect3> <refsect3> <title><function>parseResponse</function></title> <funcsynopsis> <funcprototype> <funcdef>$response = $msg->parseResponse</funcdef> <paramdef><parameter>$xmlString</parameter></paramdef> </funcprototype> </funcsynopsis> <para> æåå <parameter>$xmlString</parameter> ã«å«ã¾ãã XML-RPC ãµã¼ãããã® å¿çãåãåãã<classname>XML_RPC_Response</classname> ãªãã¸ã§ã¯ãã æ§ç¯ãã¦ãããè¿ãã¾ããã¾ãé©åãªã¨ã©ã¼ã³ã¼ããè¨å®ãã¾ãã </para> <para> ãã®ã¡ã½ããã¯ãè¦ã¤ãã£ã HTTP/MIME ãããããã¹ã¦å¦çãã¾ãã </para> </refsect3> <refsect3> <title><function>parseResponseFile</function></title> <funcsynopsis> <funcprototype> <funcdef>$response = $msg->parseResponseFile</funcdef> <paramdef><parameter>$fileHandle</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ãã¡ã¤ã«ãã³ãã« <parameter>$fileHandle</parameter> ãã XML-RPC ãµã¼ãã®å¿çãèªã¿è¾¼ã¿ãããã <function>parseResponse</function> ã«æ¸¡ãã¾ãã </para> <para> ãã®ã¡ã½ããã¯ãäºåã«ç¨æããããã¡ã¤ã«ããå¿çãçæããéã«æç¨ã§ãã ã¾ããè¦ã¤ãã£ã HTTP ãããããã¹ã¦å¦çãã¾ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.response" xreflabel="XML_RPC_Response"> <title>XML_RPC_Response</title> <para> ãã®ã¯ã©ã¹ã¯ãXML-RPC ãªã¯ã¨ã¹ãã«å¯¾ããå¿çãæ ¼ç´ããããã«ä½¿ç¨ããã¾ãã ãµã¼ãã®ã¡ã½ãããã³ãã©ã¯ <classname>XML_RPC_Response</classname> ã ä½æããè¿ãå¤ã¨ãã¦ããã渡ãã¾ãã <classname>XML_RPC_Client</classname> ã¯ã©ã¹ã® <function>send</function> ã¡ã½ãããå®è¡ããéã«ãããã¨åãå¤ãè¿ããã¾ãã </para> <refsect2> <title>çæ</title> <funcsynopsis> <funcprototype> <funcdef>$resp = new XML_RPC_Response</funcdef> <paramdef><parameter>$xmlrpcval</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$resp = new XML_RPC_Response</funcdef> <paramdef><parameter>0</parameter></paramdef> <paramdef><parameter>$errcode</parameter></paramdef> <paramdef><parameter>$errstring</parameter></paramdef> </funcprototype> </funcsynopsis> <para> ã²ã¨ã¤ãã®ã¤ã³ã¹ã¿ã³ã¹ã¯ãä½ã®åé¡ããªãå¦çãå®è¡ãããéã«ä½¿ç¨ããã¾ãã <parameter>$xmlrpcval</parameter> 㯠<classname>XML_RPC_Value</classname> ã®å¤ã§ãã¡ã½ããã®å®è¡çµæã æ ¼ç´ããã¦ãã¾ãã </para> <para> 2 çªç®ã®å½¢å¼ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ã失ææã«ä½¿ç¨ããã¾ããã©ãã«åé¡ã ãã£ãã®ãã示ãããã«ã<parameter>$errcode</parameter> ããã³ <parameter>$errstring</parameter> ã使ç¨ããã¾ãã渡ãããã¨ã©ã¼ã³ã¼ã㮠詳細ã«ã¤ãã¦ã¯ <xref linkend="package.webservices.xml-rpc.api.server" /> ãåç §ãã ããã </para> </refsect2> <refsect2> <title>ã¡ã½ãã</title> <refsect3> <title><function>faultCode</function></title> <funcsynopsis> <funcprototype> <funcdef>$fn = $resp->faultCode</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> XML-RPC ã¬ã¹ãã³ã¹ <parameter>$resp</parameter> ããã失æã®ã³ã¼ãã æ´æ°å¤ã§è¿ãã¾ããã¼ãã¯æåãããã以å¤ã®å¤ã¯å¤±æãæå³ãã¾ãã </para> </refsect3> <refsect3> <title><function>faultString</function></title> <funcsynopsis> <funcprototype> <funcdef>$fs = $resp->faultString</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <varname>$resp->faultCode</varname> ã示ã失æã®å 容ãã 人éãèªããå½¢å¼ã§è¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>value</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $resp->value</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> ãµã¼ãããéä¿¡ãããè¿ãå¤ãå«ã¾ãã <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ããè¿ãã¾ããå¿çã® <varname>faultCode</varname> ãã¼ã以å¤ã® å ´åããã®ã¡ã½ãããè¿ãå¤ã使ç¨ããã¹ãã§ã¯ããã¾ããï¼è¿ãå¤ã¯ ãªãã¸ã§ã¯ãã§ãããªãããããã¾ããï¼ã </para> </refsect3> <refsect3> <title><function>serialize</function></title> <funcsynopsis> <funcprototype> <funcdef>$outString = $resp->serialize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> å¿çããXML æååå½¢å¼ã§è¿ãã¾ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.value" xreflabel="XML_RPC_Value"> <title>XML_RPC_Value</title> <para> ããã¯ãå¤ãã®å¤§å¤ãªä»äºãæ å½ãããã®ã§ãããã®ã¯ã©ã¹ã¯ãXML-RPC ã§ä½¿ç¨ããå¤ã®ä½æã¨ã«ãã»ã«åãå¯è½ã«ãã¾ãã </para> <para> äºåã« <ulink url="&url.xmlrpc.spec;">&url.xmlrpc.spec;</ulink> 㧠XML-RPC ã®ä»æ§ãèªãã§ããã¨ããã以éã®å 容ãç解ãããããªãã§ãããã </para> <para> <classname>XML_RPC_Value</classname> ã¯ã©ã¹ã¯ã以ä¸ã®åãå©ç¨ã㦠任æã®è¤éãªå¤ãæ ¼ç´ãããã¨ãå¯è½ã§ãã <literal>i4</literal>ã <literal>int</literal>ã <literal>boolean</literal>ã <literal>string</literal>ã <literal>double</literal>ã <literal>dateTime.iso8601</literal>ã <literal>base64</literal>ã <literal>array</literal> ããã㯠<literal>struct</literal>ã ãããã®åã«ã¤ãã¦ã®è©³ç´°ãªæ å ±ã¯ <ulink url="&url.xmlrpc.spec;">ä»æ§</ulink> ãåç §ãã ããã </para> <refsect2> <title>åã«ã¤ãã¦ã®æ³¨æ</title> <refsect3> <title>int</title> <para> <classname>i4</classname> å㯠<classname>int</classname> ã®å¥åã§ããã³ã¼ãä¸ã§å¤ã解æããéã«ã¯ èªåçã« <classname>i4</classname> ã <classname>int</classname> ã«å¤æããã¾ãããã®å®è£ ã§ã¯ã<classname>int</classname> ã®ã»ãã æ£å¼åã¨ã¿ãªãã¦ãã¾ãã </para> </refsect3> <refsect3> <title>base64</title> <para> ãã®åã使ç¨ããã¨ãBase64 ã¨ã³ã³ã¼ãã£ã³ã°ãééçã«è¡ããã¾ãã ãã®ãããããã¯ãã¤ããªãã¼ã¿åã¨ãã¦æ±ãã¹ãã§ã7 ãããã¯ãªã¼ã³ ã§ã¯ãªããã¼ã¿ã渡ãããå ´åã«ä½¿ç¨ãã¾ãããã³ã¼ãå¦çãã¾ã ééçã«è¡ããã¾ãã </para> </refsect3> <refsect3> <title>boolean</title> <para> <literal>true</literal> ããã³ <literal>1</literal> 㯠<literal>true</literal> ã«ãããããã¾ãããã以å¤ã®ãã¹ã¦ã®å¤ ï¼ç©ºæååãå«ãï¼ã¯ <literal>false</literal> ã«å¤æããã¾ãã </para> </refsect3> <refsect3> <title>string</title> <para> <literal><</literal>ã <literal>></literal>ã <literal>"</literal> ããã³ <literal>&</literal> ã®åæåã¯ã XML-RPC ã§ã®éä¿¡ã®éã«åã ã¨ç価ãªã¨ã³ãã£ã㣠<literal>&lt;</literal>ã <literal>&gt;</literal>ã <literal>&quot;</literal> ããã³ <literal>&amp;</literal> ã«å¤æããã¾ããç¾å¨ã® XML-RPC ã®ä»æ§ã§ã¯ ã¨ã³ã³ã¼ãããããæ¨å¥¨ããã¦ããã®ã¯ <literal><</literal> ããã³ <literal>&</literal> ã ãã§ããããã®å®è£ ã§ã¯ããã«ä¸æ©å ãè¡ã£ã¦ãã¾ãã ãã®çç±ã¯ <ulink url="&url.w3.xml.rec;">XML 1.0 å§å</ulink> ã§èª¬æããã¦ãã¾ãã </para> <para> TODO: <literal>&apos;</literal> ã¨ã³ãã£ãã£ã¯ç¾å¨ãµãã¼ãããã¦ãã¾ããã </para> </refsect3> </refsect2> <refsect2 id="package.webservices.xml-rpc.api.value.creation" xreflabel="XML_RPC_Value constructors"> <title>çæ</title> <para> ã³ã³ã¹ãã©ã¯ã¿ã¯ã<classname>XML_RPC_Value</classname> ãçæããããã®ä¸è¬çãªæ¹æ³ã§ããã³ã³ã¹ãã©ã¯ã¿ã¯ä»¥ä¸ã®ãããªæ§æã§ãã </para> <funcsynopsis> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef></paramdef> </funcprototype> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef><parameter>$stringVal</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef><parameter>$scalarVal</parameter></paramdef> <paramdef><parameter>'int' | 'boolean' | 'string' | 'double' | 'dateTime.iso8601' | 'base64'</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$myVal = new XML_RPC_Value</funcdef> <paramdef><parameter>$arrayVal</parameter></paramdef> <paramdef><parameter>'array' | 'struct'</parameter></paramdef> </funcprototype> </funcsynopsis> <para> æåã®ã³ã³ã¹ãã©ã¯ã¿ã¯ç©ºã®å¤ãçæãã¾ãã使ç¨ããåã«ãå¿ ã <function>addScalar</function>ã <function>addArray</function> ããã㯠<function>addStruct</function> ã§åæåããªããã°ãªãã¾ããã </para> <para> 2 çªç®ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ã·ã³ãã«ãªæååå¤ãçæãã¾ãã </para> <para> 3 çªç®ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ã¹ã«ã©å¤ãçæããããã«ä½¿ç¨ããã¾ãã 第 2 ãã©ã¡ã¼ã¿ã¯ã以ä¸ã®ä¾ã®ããã« XML-RPC åã®ååã§ããå¿ è¦ãããã¾ãã </para> <programlisting role="php"> <![CDATA[ $myInt = new XML_RPC_Value(1267, "int"); $myString= new XML_RPC_Value("Hello, World!", "string"); $myBool = new XML_RPC_Value(1, "boolean"); ]]> </programlisting> <para> 4 çªç®ã®å½¢å¼ã®ã³ã³ã¹ãã©ã¯ã¿ã¯ãè¤é㪠XML-RPC ã®å¤ãä½æããã®ã« 使ç¨ããã¾ããå¤ã XML-RPC ã® <classname>é å</classname> ã§ããå ´å㯠åç´ãªé åã<classname>æ§é ä½</classname> ã®å ´åã¯é£æ³é åã 第 1 ãã©ã¡ã¼ã¿ã«æå®ãã¾ããé åã®è¦ç´ 㯠<emphasis> <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã§ããå¿ è¦ãããã¾ã </emphasis>ãä¾ãã°ä»¥ä¸ã®ããã«ãªãã¾ãã </para> <programlisting> <![CDATA[ $myArray = new XML_RPC_Value(array( new XML_RPC_Value("Tom"), new XML_RPC_Value("Dick"), new XML_RPC_Value("Harry")), "array"); $myStruct = new XML_RPC_Value(array( "name" => new XML_RPC_Value("Tom"), "age" => new XML_RPC_Value(34, "int"), "geek" => new XML_RPC_Value(1, "boolean")), "struct"); ]]> </programlisting> </refsect2> <refsect2 id="package.webservices.xml-rpc.api.value.methods" xreflabel="XML_RPC_Value methods"> <title>ã¡ã½ãã</title> <refsect3> <title><function>addScalar</function></title> <funcsynopsis> <funcprototype> <funcdef>$ok = $val->addScalar</funcdef> <paramdef><parameter>$stringVal</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>$ok = $val->addScalar</funcdef> <paramdef><parameter>$scalarVal</parameter></paramdef> <paramdef><parameter>'int' | 'boolean' | 'string' | 'double' | 'dateTime.iso8601' | 'base64'</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã空㮠<classname>XML_RPC_Value</classname> ã ã£ãå ´åããã®ã¡ã½ãã㯠ããã«ã¹ã«ã©å¤ãè¨å®ãã¾ãããã§ã« <parameter>$val</parameter> ã« ã¹ã«ã©å¤ãè¨å®ããã¦ããå ´åãæ°ãã«ã¹ã«ã©å¤ã追å ããããã¨ã¯ãªã <literal>0</literal> ãè¿ããã¾ãããã¹ã¦ã®å¦çããã¾ãçµäºããå ´å㯠<literal>1</literal> ãè¿ããã¾ãã </para> <para> <parameter>$val</parameter> ã <classname>é å</classname> ã ã£ãå ´åã¯ç¹å¥ã§ãã¹ã«ã©å¤ãé åã«è¿½å ããã¾ãã </para> </refsect3> <refsect3> <title><function>addArray</function></title> <funcsynopsis> <funcprototype> <funcdef>$ok = $val->addArray</funcdef> <paramdef><parameter>$arrayVal</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 空㮠<classname>XML_RPC_Value</classname> ãã <parameter>$arrayVal</parameter> ã§æå®ããå 容㮠<classname>é å</classname> ã«å¤æãã¾ãã詳細ãªæ å ±ã¯ã4 çªç®ã® ã³ã³ã¹ãã©ã¯ã¿ã®æ¸å¼ãåç §ãã ããã </para> </refsect3> <refsect3> <title><function>addStruct</function></title> <funcsynopsis> <funcprototype> <funcdef>$ok = $val->addArray</funcdef> <paramdef><parameter>$assocArrayVal</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 空㮠<classname>XML_RPC_Value</classname> ãã <parameter>$assocArrayVal</parameter> ã§æå®ããå 容㮠<classname>æ§é ä½</classname> ã«å¤æãã¾ãã詳細ãªæ å ±ã¯ã4 çªç®ã® ã³ã³ã¹ãã©ã¯ã¿ã®æ¸å¼ãåç §ãã ããã </para> </refsect3> <refsect3> <title><function>kindOf</function></title> <funcsynopsis> <funcprototype> <funcdef>$kind = $val->kindOf</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> å¤ã®åã表ãæåå <literal>struct</literal>ã<literal>array</literal> ããã㯠<literal>scalar</literal> ãè¿ãã¾ããããå¤ã ã¾ã åæåããã¦ããªãå ´å㯠<literal>undef</literal> ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>serialize</function></title> <funcsynopsis> <funcprototype> <funcdef>$outString = $val->serialize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> å¤ããXML-RPC å½¢å¼ã®æååã§è¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>scalarval</function></title> <funcsynopsis> <funcprototype> <funcdef>$scalarVal = $val->scalarval</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <function>$val->kindOf</function> == 'scalar' ã®å ´åã ãã®ã¡ã½ãã㯠PHP è¨èªã®ã¹ã«ã©å¤ãè¿ãã¾ãï¼Base64 ãã³ã¼ãå¦çã¯èªåçã«è¡ããã¾ãï¼ã </para> </refsect3> <refsect3> <title><function>scalartyp</function></title> <funcsynopsis> <funcprototype> <funcdef>$typeName = $val->scalartyp</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <function>$val->kindOf</function> == 'scalar' ã®å ´åã ãã®ã¡ã½ããã¯ã¹ã«ã©ã®åã表ãæååãè¿ãã¾ããå ã«è¿°ã¹ãã¨ããã <literal>i4</literal> ã¯å¸¸ã« <literal>int</literal> ã«å¤æããã¾ãã </para> </refsect3> <refsect3> <title><function>arraymem</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $val->arraymem</funcdef> <paramdef><parameter>$n</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã§è¡¨ãããé åããã <parameter>$n</parameter> çªç®ã®è¦ç´ ãè¿ãã¾ãã è¿ãããå¤ã¯ <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã§ãã </para> </refsect3> <refsect3> <title><function>arraysize</function></title> <funcsynopsis> <funcprototype> <funcdef>$len = $val->arraysize</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã <classname>array</classname> ã®å ´åããã®é åã®è¦ç´ æ°ãè¿ãã¾ãã </para> </refsect3> <refsect3> <title><function>structmem</function></title> <funcsynopsis> <funcprototype> <funcdef>$xmlrpcVal = $val->structmem</funcdef> <paramdef><parameter>$memberName</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã§è¡¨ãããæ§é ä½ããã <parameter>$memberName</parameter> ã«å¯¾å¿ããè¦ç´ ãè¿ãã¾ãã è¿ãããå¤ã¯ <classname>XML_RPC_Value</classname> ãªãã¸ã§ã¯ãã§ãã </para> </refsect3> <refsect3> <title><function>structeach</function></title> <funcsynopsis> <funcprototype> <funcdef>list($key,$value) = $val->structeach</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ãæ§é ä½ã®å ´åã«ã次㮠ããã¼ã»å¤ãã®çµã¿åãããè¿ãã¾ãã<xref linkend="package.webservices.xml-rpc.api.value.methods.structreset" /> ãåç §ãã ããã </para> </refsect3> <refsect3 id="package.webservices.xml-rpc.api.value.methods.structreset" xreflabel="structreset()"> <title><function>structreset</function></title> <funcsynopsis> <funcprototype> <funcdef>$val->structreset</funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> <parameter>$val</parameter> ã§è¡¨ãããæ§é ä½ã«ã¤ãã¦ã <function>structeach</function> ã®å é¨ãã¤ã³ã¿ãæ§é ä½ã®å é ã«æ»ãã¾ãã </para> </refsect3> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.server" xreflabel="XML_RPC_Server"> <title>XML_RPC_Server</title> <para> ãã®ã¯ã©ã¹ã®ç¾å¨ã®å®è£ ã¯ãã§ããéãã·ã³ãã«ã§ãããã¨ãå¿ããã¦ãã¾ãã åºæ¬çã«ã¯ãã³ã³ã¹ãã©ã¯ã¿ããã¹ã¦ã®ä»äºãããªãã¾ããæä½éã®ä¾ã¯ 以ä¸ã®ã¨ããã§ãã </para> <programlisting role="php"> <![CDATA[ function foo ($params) { ... } $s = new XML_RPC_Server(array("examples.myFunc" => array("function" => "foo"))); ]]> </programlisting> <para> ããã¯ããµã¼ãã§å®è¡ããããä»äºããã¹ã¦è¡ã£ã¦ããã¾ãããã£ãã²ã¨ã¤ã® å¼æ°ã¯é£æ³é åã§ãããã¡ã½ããåã¨é¢æ°åã対å¿ããã¾ãããªã¯ã¨ã¹ãã 解æãããã¨é©åãªé¢æ°ãå¼ã³åºãããé¢æ°ãè¿ã <classname>XML_RPC_Response</classname> ãªãã¸ã§ã¯ãã¯ã·ãªã¢ã©ã¤ãºãã㦠ã³ã¼ã«å ã«è¿ããã¾ãã </para> <para> ãã³ãã©é¢æ° <function>foo</function> ãä½ãè¡ãã®ãã«ã¤ãã¦ã ããããã詳ããè¦ã¦ã¿ã¾ãããã </para> <programlisting role="php"> <![CDATA[ function foo ($params) { global $XML_RPC_erruser; // ã¦ã¼ã¶ã¨ã©ã¼ã³ã¼ãã®å¤ãã¤ã³ãã¼ã // $params ã¯ãåä¿¡ãã XML_RPC_Message ãªãã¸ã§ã¯ã if ($err) { // ã¨ã©ã¼ãçºçããå ´å return new XML_RPC_Response(0, $XML_RPC_erruser+1, // ã¦ã¼ã¶ã¨ã©ã¼ 1 "è¦é·ãåé¡ãçºçãã¾ããã"); } else { // å¦çãæåããéã«è¿ãå¤ return new XML_RPC_Response(new XML_RPC_Value("ä¸äºé 調!", "string")); } } ]]> </programlisting> <refsect2> <title>ãã£ã¹ãããããã</title> <para> <function>XML_RPC_Server</function> ã³ã³ã¹ãã©ã¯ã¿ã®æåã®å¼æ°ã¯é åã§ã <emphasis>ãã£ã¹ãããããã</emphasis>ã¨å¼ã°ãã¾ãããã®é åã®ä¸ã«ããã®ã¯ã ããªããå®ç¾©ãã XML-RPC ã¡ã½ãããæä¾ããããã«å¿ è¦ãªæ å ±ã§ãã </para> <para> ãã£ã¹ããããããã¯ãé£æ³é åã®é£æ³é åã¨ããå½¢å¼ã«ãªãã¾ãã å¤å´ã®é åã¯åã ã®ã¡ã½ããã«å¯¾ãã¦ã²ã¨ã¤ã®ã¨ã³ããªãæã¡ã ã¡ã½ããåãé£æ³é åã®ãã¼ã¨ãªãã¾ãããã¼ã«å¯¾å¿ããå¤ã¯å¥ã®é£æ³é åã§ã 以ä¸ã®ãããªã¡ã³ããä¿æãã¾ãã </para> <itemizedlist> <listitem> <para> <parameter>function</parameter> - ãã®ã¨ã³ããªã¯å¿ é ã§ãã XML-RPC ã¡ã½ãããæä¾ããããã«ä½¿ç¨ããã°ãã¼ãã«ã¹ã³ã¼ãã®é¢æ°åã§ãã å¿ è¦ãããã¾ãã </para> </listitem> <listitem> <para> <parameter>signature</parameter> - ãã®ã¨ã³ããªã¯ãã¡ã½ãããã¨ããã ã·ã°ããã£ï¼<xref linkend="package.webservices.xml-rpc.api.server.signatures" /> ãåç §ãã ããï¼ãå«ãé åã§ãããã®ã¨ã³ããªãåå¨ããå ´åã ã¡ã½ãããå²ãæ¯ãåã«ãµã¼ãå´ã§å¼æ°ã®æ°ãåã®ãã§ãã¯ãè¡ãã¾ãã </para> </listitem> <listitem> <para> <parameter>docstring</parameter> - ãã®ã¨ã³ããªã¯ãã¡ã½ããã® ããã¥ã¡ã³ããå«ãæååã§ããããã¥ã¡ã³ãã«ã¯ HTML ãã¼ã¯ã¢ããã å«ãããã¨ãå¯è½ã§ãã </para> </listitem> </itemizedlist> </refsect2> <refsect2 id="package.webservices.xml-rpc.api.server.signatures" xreflabel="Signatures"> <title>ã¡ã½ããã®ã·ã°ããã£</title> <para> ã·ã°ããã£ã¨ã¯ãã¡ã½ããã®è¿ãå¤ã®åããã®ãã©ã¡ã¼ã¿ã®åã示ããã®ã§ãã ã¡ã½ããã¯ããããªãã¨ãã²ã¨ã¤ã®ã·ã°ããã£ãæã£ã¦ãã¾ãã </para> <para> ãµã¼ãã®ãã£ã¹ããããããå ã§ã¯ãåã ã®ã¡ã½ããã¯ã¨ãããã·ã°ããã£ã® é åãä¿æãã¦ãã¾ããåã·ã°ããã£ã®ä¸èº«ã¯åã®é åã§ãæåã®ã¨ã³ããªã¯ è¿ãå¤ã®åã§ãã </para> <para> ä¾ãå®è¡ãã¦ã¿ã¾ãããããã®ãããªæ®éã® PHP é¢æ°ãæ¸ããã¨ãã¦ããç¶æ³ã æ³å®ãã¦ãã ããã <programlisting role="php"> <![CDATA[ function is_8($input, $strict = false) { if ($strict) { return ($input === 8); } else { return ($input == 8); } } ]]> </programlisting> </para> <para> ãã®é¢æ°ã XML_RPC ãµã¼ãã§åä½ããããã¨ããã¨ããã®ããã« æ¸ãå¿ è¦ãããã¾ãã <programlisting role="php"> <![CDATA[ function is_8($params) { // ãã®ãã©ã¡ã¼ã¿ã¯å¿ é $param = $params->getParam(0); if (!XML_RPC_Value::isValue($param)) { return $param; } $input = $param->scalarval(); // ãã®ãã©ã¡ã¼ã¿ã¯ãªãã·ã§ã³ $param = $params->getParam(1); if (!XML_RPC_Value::isValue($param)) { $strict = false; } else { $strict = $param->scalarval(); } if ($strict) { $answer = ($input === 8); } else { $answer = ($input == 8); } $val = new XML_RPC_Value($answer, 'boolean'); return new XML_RPC_Response($val); } ]]> </programlisting> </para> <para> ããã¯ãã¨ãããé çªã®ã·ã°ããã£ããã¹ã¦ç¶²ç¾ ãããã®ã§ãã <programlisting role="php"> <![CDATA[ array( array('boolean', 'int'), array('boolean', 'int', 'boolean'), array('boolean', 'string'), array('boolean', 'string', 'boolean'), ) ]]> </programlisting> </para> <para> ãµã¼ãã¯ãã®ããã«ãã¦ã¤ã³ã¹ã¿ã³ã¹åãã¾ãã <programlisting role="php"> <![CDATA[ $server = new XML_RPC_Server( array( 'isan8' => array( 'function' => 'is_8', 'signature' => array( array('boolean', 'int'), array('boolean', 'int', 'boolean'), array('boolean', 'string'), array('boolean', 'string', 'boolean'), ), 'docstring' => 'å¤ã¯ 8 ã§ãã?' ), ), 1, 0 ); ]]> </programlisting> </para> <para> 使ãããããèæ ®ããXML-RPC ã®åã表ãæååãã°ãã¼ãã«å¤æ°ã¨ã㦠ã³ã¼ãåããã¦ãã¾ãã </para> <programlisting role="php"> <![CDATA[ $XML_RPC_I4 = 'i4'; $XML_RPC_Int = 'int'; $XML_RPC_Boolean = 'boolean'; $XML_RPC_Double = 'double'; $XML_RPC_String = 'string'; $XML_RPC_DateTime = 'dateTime.iso8601'; $XML_RPC_Base64 = 'base64'; $XML_RPC_Array = 'array'; $XML_RPC_Struct = 'struct'; ]]> </programlisting> </refsect2> <refsect2> <title>ãµã¼ãããã®å¿çã®é 延</title> <para> ããªããä½ããã¨ãã¦ãããµã¼ãã§ã¯ãä½ããã®çç±ï¼ãã¨ãã° ã»ãã¥ãªãã£èªè¨¼ãªã©ï¼ã«ãããªã¯ã¨ã¹ãã«å¯¾ããå¿çããã£ããä¿çããã ãã¨ãããã§ããããã³ã³ã¹ãã©ã¯ã¿ã® 2 çªç®ã®å¼æ°ã« <literal>0</literal> ã渡ãã¨ããæã¿ã®å¹æãå¾ããã¾ãããã®å¾ã ãµã¼ãã¯ã©ã¹ã® <function>service</function> ã¡ã½ããã使ç¨ã㦠ãªã¯ã¨ã¹ããå¦çããã°ããã®ã§ãããã¨ãã°ä»¥ä¸ã®ããã«ãªãã¾ãã </para> <programlisting role="php"> <![CDATA[ $s = new XML_RPC_Server($myDispMap, 0); // ... ä½ããã®ä»ã®å¦çãããã§è¡ã $s->service(); ]]> </programlisting> </refsect2> <refsect2> <title>失æã®å ±å</title> <para> ãµã¼ããè¿ã失æã³ã¼ãã¯ãã°ãã¼ãã«ã® <literal>$xmlrpcerruser</literal> ãæãå¤ã« 1 ãå ããå¤ããéå§ããã¹ãã§ãã </para> <para> ãµã¼ããè¿ãæ¨æºçãªã¨ã©ã¼ã«ã¯ä»¥ä¸ã®ãããªãã®ãããã¾ãã </para> <variablelist> <varlistentry> <term> <literal>1</literal> <phrase>Unknown method</phrase> </term> <listitem> <para> ãµã¼ããé¢ç¥ããªãã¡ã½ããã®å®è¡ãè¦æ±ãããéã«è¿ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>2</literal> <phrase>Invalid return payload</phrase> </term> <listitem> <para> ãã®ã¨ã©ã¼ã¯ãå®éã®ã¨ãããµã¼ããã³ã¼ãã§ã¯ãªãã¯ã©ã¤ã¢ã³ãå´ã§ çºçãã¾ããããããããã¯ãµã¼ããèªåã§ç解ã§ããªãä½ããè¿ãããã¨ã 示ãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>3</literal> <phrase>Incorrect parameters</phrase> </term> <listitem> <para> ãµã¼ããã¡ã½ããã«å¯¾å¿ããã·ã°ããã£ãä¿æãã¦ãããã¯ã©ã¤ã¢ã³ããã 渡ããããã©ã¡ã¼ã¿ããããã®ã·ã°ããã£ã«ãä¸è´ããªãã£ãéã«çºçãã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>4</literal> <phrase>Can't introspect: method unknown</phrase> </term> <listitem> <para> ãã®ã¨ã©ã¼ã¯ãçµã¿è¾¼ã¿ã® <function>system.*</function> ã¡ã½ãããã çºçãããã®ã§ããµã¼ãä¸ã§æªå®ç¾©ã®ã¡ã½ãããå®è¡ãããã¨ããéã«èµ·ããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>5</literal> <phrase>Didn't receive 200 OK from remote server</phrase> </term> <listitem> <para> ãã®ã¨ã©ã¼ã¯ããµã¼ãããã®å¿çã¨ã㦠HTTP/1.1 200 OK ãæ»ã£ã¦ããªãã£ãéã« ã¯ã©ã¤ã¢ã³ãå´ã§çºçãã¾ããã¨ã©ã¼ã®è©³ç´°ãªæ å ±ã¯ãä¸ã®ã¡ãã»ã¼ã¸ã®æå¾ã« ä»ãå ãããã¾ãã </para> </listitem> </varlistentry> <varlistentry> <term> <literal>100-</literal> <phrase>XML parse errors</phrase> </term> <listitem> <para> çºçããé害㮠XML ãã¼ãµã¨ã©ã¼ã³ã¼ãã« 100 ãå ãããã®ãè¿ãã¾ãã è¿ããã <varname>faultString</varname> ã®ä¸ã«ã¯ãå ¥å XML ã¹ããªã¼ã ã® ã©ãã§ãã¼ã¹ã¨ã©ã¼ãçºçããã®ãã示ããã¦ãã¾ãã </para> </listitem> </varlistentry> </variablelist> </refsect2> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.dump" xreflabel="XML_RPC_Dump"> <title>XML_RPC_Dump</title> <para> ãã®ã¯ã©ã¹ã¯ãXML_RPC_Value ãªãã¸ã§ã¯ãå ã®ãã¼ã¿ã® æåå表ç¾ãçæãã¾ãã </para> </refsect1> <refsect1 id="package.webservices.xml-rpc.api.other" xreflabel="other"> <title>ãã®ä»ã®é¢æ°</title> <para> 以ä¸ã¯ XML_RPC ãªãã¸ã§ã¯ãã®å¤é¨ã«ããé¢æ°ã§ãã </para> <refsect2> <title><function>XML_RPC_encode</function></title> <funcsynopsis> <funcprototype> <funcdef>$rpc = XML_RPC_encode</funcdef> <paramdef><parameter>$php_val</parameter></paramdef> </funcprototype> </funcsynopsis> <para> PHP ã®ãã¤ãã£ããã¼ã¿åãåãåããããã XML_RPC ãªãã¸ã§ã¯ãåã« å¤æãã¾ãã </para> </refsect2> <refsect2> <title><function>XML_RPC_decode</function></title> <funcsynopsis> <funcprototype> <funcdef>$values = XML_RPC_decode</funcdef> <paramdef><parameter>$XML_RPC_val</parameter></paramdef> </funcprototype> </funcsynopsis> <para> XML_RPC ãªãã¸ã§ã¯ãåã®ã¡ãã»ã¼ã¸ãåãåããããã PHP ã® ãã¤ãã£ããã¼ã¿åã«å¤æãã¾ãã </para> </refsect2> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/examples.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/examples.xml +++ peardoc/ja/package/webservices/xml-rpc/examples.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.7 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.examples"> <refnamediv> <refname>ä¾</refname> <refpurpose>XML_RPC ããã±ã¼ã¸ã®å©ç¨ä¾</refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.examples.latest"> <title> ã¯ã©ã¤ã¢ã³ãã使ç¨ãã¦ãPEAR ã®ææ°æ å ±ãåå¾ãã </title> <example> <title /> <programlisting role="php"> <![CDATA[ require_once 'XML/RPC.php'; /* * ãã¡ã°ãæè¿ã«ãªãªã¼ã¹ããã PEAR ããã±ã¼ã¸ã®æ å ±ãåå¾ãã */ $params = array(new XML_RPC_Value(1, 'int')); $msg = new XML_RPC_Message('release.getRecent', $params); $cli = new XML_RPC_Client('/xmlrpc.php', 'pear.php.net'); // $cli->setDebug(1); $resp = $cli->send($msg); if (!$resp) { echo 'Communication error: ' . $cli->errstr; exit; } if (!$resp->faultCode()) { $val = $resp->value(); $data = XML_RPC_decode($val); echo $data[0]['name'] . ' is at version ' . $data[0]['version']; } else { /* * xmlrpc.php ã¹ã¯ãªãããééããåé¡ã * å ±åãã */ echo 'Fault Code: ' . $resp->faultCode() . "\n"; echo 'Fault Reason: ' . $resp->faultString() . "\n"; } ]]> </programlisting> </example> </refsect1> <refsect1 id="package.webservices.xml-rpc.examples.complete"> <title>ã¯ã©ã¤ã¢ã³ã - ãµã¼ã ã®çµã¿åãã</title> <example> <title /> <para> ããããµã¼ãå´ã®ã¹ã¯ãªããã§ããlocalhost ã® web ãµã¼ãã® ããã¥ã¡ã³ãã«ã¼ãã«ãxmlrpc.php ã¨ããååã§è¨ç½®ãã¾ãã </para> <programlisting role="php"> <![CDATA[ require_once 'XML/RPC/Server.php'; function returnTimes2($params) { $param = $params->getParam(0); // ãã®ã¨ã©ã¼ãã§ãã¯æ§æã¯ããªãªã¼ã¹ 1.3.0 ã§è¿½å ããã¾ãã if (!XML_RPC_Value::isValue($param)) { return $param; } $val = new XML_RPC_Value($param->scalarval() * 2, 'int'); return new XML_RPC_Response($val); } $server = new XML_RPC_Server( array( 'times2' => array( 'function' => 'returnTimes2' ) ) ); ]]> </programlisting> <para> ããã¦ãã¡ããã¯ã©ã¤ã¢ã³ãå´ã®ã¹ã¯ãªããã§ãã </para> <programlisting role="php"> <![CDATA[ require_once 'XML/RPC.php'; $input = 8; $params = array(new XML_RPC_Value($input, 'int')); $msg = new XML_RPC_Message('times2', $params); $cli = new XML_RPC_Client('/xmlrpc.php', 'localhost'); // $cli->setDebug(1); $resp = $cli->send($msg); if (!$resp) { echo 'Communication error: ' . $cli->errstr; exit; } if (!$resp->faultCode()) { $val = $resp->value(); echo $input . ' times 2 is ' . $val->scalarval(); } else { /* * xmlrpc.php ã¹ã¯ãªãããééããåé¡ã * å ±åãã */ echo 'Fault Code: ' . $resp->faultCode() . "\n"; echo 'Fault Reason: ' . $resp->faultString() . "\n"; } ]]> </programlisting> </example> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/intro.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/intro.xml +++ peardoc/ja/package/webservices/xml-rpc/intro.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.intro"> <refnamediv> <refname>å°å ¥</refname> <refpurpose></refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.intro.general"> <title>æ¦è¦ã®ç´¹ä»</title> <para> XML-RPC ã¯ãXML ãç¨ãããªã¢ã¼ãããã·ã¼ã¸ã£ã³ã¼ã«ãå®ç¾ããããã« <ulink url="&url.userland;">Userland Software</ulink> ãèæ¡ãã ãã©ã¼ãããã§ããXML-RPC ã® web ãµã¤ã㯠<ulink url="&url.xmlrpc;">www.XmlRpc.com</ulink> ã§ãã </para> <para> ç¾æç¹ã§ä½¿ç¨å¯è½ãª XML-RPC ã®å®è£ ã®ã»ã¨ãã©ã¯ããã¼ã¿äº¤æã« HTTP ã使ç¨ãã¦ãã¾ããPerl ã Python ãªã©ä»ã®è¨èªã§ã®å®è£ ã®ä¸è¦§ã <ulink url="&url.xmlrpc;">www.xmlrpc.com</ulink> ã«ããã¾ãã </para> <para> ãã® PHP ã¯ã©ã¹ç¾¤ã¯ãXML-RPC ã®ã¯ã©ã¤ã¢ã³ãããã³ãµã¼ãã PHP 㧠è¨è¿°ããããã®ãã¬ã¼ã ã¯ã¼ã¯ãæä¾ãã¾ãã </para> </refsect1> <refsect1 id="package.webservices.xml-rpc.intro.acknowledgements"> <title>è¬è¾</title> <para> ãã®ããã±ã¼ã¸ã¯ãUseful Information Company ã® <ulink url="&url.usefulinc;">Edd Dumbill</ulink> ã«ãã£ã¦æåã«æ¸ããã¾ããã æãè³è³ãããã¹ããªã®ã¯å½¼ã§ããæåã®ã³ã¼ããã¼ã¹ã«å¯¾ãã¦è²¢ç®ãã 以ä¸ã®äººã ã¯å¥ã¨ãã¦ããã®ã³ã¼ãã¯ç¾å¨ã Edd ã«ãã£ã¦ä¿å®ããã¦ãã¾ãã </para> <itemizedlist> <listitem> <para>Jim Winstead <email>jimw at php dot net</email></para> </listitem> <listitem> <para>Peter Kocks <email>peter.kocks at baygate dot com</email></para> </listitem> <listitem> <para>Nicolay Mausz <email>mausz at flying-dog dot com</email></para> </listitem> <listitem> <para>Ben Margolin <email>ben at wendy.auctionwatch dot com</email></para> </listitem> <listitem> <para>Dan Libby <email>dan at libby dot com</email></para> </listitem> <listitem> <para>Gaetano Giunta <email>g.giunta at libero dot it</email></para> </listitem> <listitem> <para>Idan Sofer <email>i_sofer at yahoo dot com</email></para> </listitem> <listitem> <para>Giancarlo Pinerolo <email>ping at alt dot it</email></para> </listitem> <listitem> <para>Justin Miller <email>justin at voxel dot net</email></para> </listitem> </itemizedlist> </refsect1> <refsect1 id="package.webservices.xml-rpc.intro.manifest"> <title>ãã¡ã¤ã«ä¸è¦§ - ããã±ã¼ã¸å ã®ãã¡ã¤ã«</title> <titleabbrev>ãã¡ã¤ã«ä¸è¦§</titleabbrev> <glosslist> <glossentry> <glossterm>Server.php</glossterm> <glossdef> <para> XML-RPC ãµã¼ãã¯ã©ã¹ããµã¼ãæ©è½ã使ç¨ããããããã«ãããã <function>include</function> ãã¾ãã </para> </glossdef> </glossentry> <glossentry> <glossterm>RPC.php</glossterm> <glossdef> <para> XML-RPC ã¯ã©ã¤ã¢ã³ãã¯ã©ã¹ãã¯ã©ã¤ã¢ã³ãæ©è½ã使ç¨ããããã«ãããã <function>include</function> ãã¾ãã </para> </glossdef> </glossentry> </glosslist> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/peardoc/ja/package/webservices/xml-rpc/support.xml?r=1.1&p=1 Index: peardoc/ja/package/webservices/xml-rpc/support.xml +++ peardoc/ja/package/webservices/xml-rpc/support.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="package.webservices.xml-rpc.support"> <refnamediv> <refname>ãµãã¼ã</refname> <refpurpose>XML_RPC ã®ãµãã¼ããåããã«ã¯</refpurpose> </refnamediv> <refsect1 id="package.webservices.xml-rpc.support.online"> <title>ãªã³ã©ã¤ã³ãµãã¼ã</title> <para> ãã®ããã±ã¼ã¸ã¯<quote>ãããã¾ã¾ï¼as-isï¼</quote>ã§æä¾ããã¦ããã ä½ããã®è£åãããããµãã¼ãã®ç´æãããããããã®ã§ã¯ããã¾ããã ããããPEAR ã¦ã¼ã¶ã¡ã¼ãªã³ã°ãªã¹ãã XML-RPC.com ã«ã¦ éå ¬å¼ãªã¢ããã¤ã¹ããã«ããè¡ã£ã¦ãã¾ãã </para> <itemizedlist> <listitem> <para> ããã±ã¼ã¸ã®ä½¿ç¨æ³ã«é¢ãã質åã¯ã <ulink url="mailto:&email.pear.general;">PEAR ã¦ã¼ã¶ã¡ã¼ãªã³ã°ãªã¹ã </ulink> ãéãã¦è¡ã£ã¦ãã ããã詳細㯠<ulink url="&url.pear.support;">ãã¡ããã覧ãã ãã</ulink>ã </para> </listitem> <listitem> <para> XML-RPC ã«ã¤ãã¦ã®ä¸è¬çãªè³ªåã«ã¯ãYahoo! ã°ã«ã¼ãã® <ulink url="&url.xmlrpc.list;">XML-RPC ã¡ã¼ãªã³ã°ãªã¹ã</ulink>ãå©ç¨ã§ãã¾ãã </para> </listitem> <listitem> <para> XML-RPC ã®ä½¿ç¨æ³ã«ã¤ãã¦ã®å©è¨ãå¾ãã«ã¯ã<ulink url="&url.xmlrpc.discuss;">XML-RPC.com</ulink> ã®æ²ç¤ºæ¿ã便å©ã§ãã ãã®æ²ç¤ºæ¿ã®å 容ã¯ãYahoo! Groups ã®ã¡ã¼ãªã³ã°ãªã¹ãã«ãåæ ããã¾ãã </para> </listitem> </itemizedlist> </refsect1> <refsect1 id="package.webservices.xml-rpc.support.jellyfish"> <title>ã¯ã©ã²æ¬</title> <para> <graphic fileref="http://www.oreilly.com/catalog/covers/progxmlrpc.s.gif" format="GIF" width="145" depth="190" align="right"></graphic> Simon St.Laurent ã Joe Johnston ã¨ã¨ãã« Edd Dumbill ãæ¸ãã XML-RPC ã«ã¤ãã¦ã®æ¬ããO'Reilly and Associates ããçºå£²ããã¦ãã¾ãã ãã®æ¬ã®è¡¨ç´ã«ã¯ãã¡ãã£ã¨ç®ãå¼ãã¯ã©ã²ãæããã¦ãã¾ãã </para> <para> ãã®æ¬ã«ã¤ãã¦ã®è©³ç´°ã¯ã<ulink url="&url.xmlrpc.book;">O'Reilly ã® web ãµã¤ãããå¾ããã¾ã</ulink>ã </para> <para> Edd 㯠PHP ã«é¢ããç« ãæ å½ãã¦ãããå®éã«åä½ããä¾ãåé²ããã¦ãã¾ãã ãã®å 容ã¯ãæ²ç¤ºæ¿ãµã¼ããç«ã¡ä¸ããO'Reilly ã® <ulink url="&url.meerkat;">Meerkat</ulink> ãµã¼ãã¹ãç¨ã㦠Web ä¸ã® ãã¥ã¼ã¹è¨äºã«å¯¾ããã³ã¡ã³ããè¡ããã®ã§ãã </para> <para> ããããã½ããã¦ã§ã¢ãæ¸ãä¸ããå½¼ã®å´åã®ãããã§ä½ããã®æ©æµãåãã ãªãããã²ãã®æ¬ãè³¼å ¥ãããã¨ãèãã¦ãã ããã </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->