call() のパラメータをネイティブの PHP 型で渡します。つまり String 、 Integer 、 Float 、 Boolean 、 Array あるいは Object で渡すということです。 このとき、PHP のネイティブ型は自動的に検出され、 以下の表にしたがって XML-RPC 型に変換されます。

PHP と XML-RPC の間の型変換

PHP ネイティブ型	XML-RPC 型
integer	int
Zend_Crypt_Math_BigInteger	i8
double	double
boolean	boolean
string	string
null	nil
array	array
associative array	struct
object	array
Zend_Date	dateTime.iso8601
DateTime	dateTime.iso8601

注意: 空の配列はどの型に変換されるの?
空の配列を XML-RPC メソッドに渡すことには問題があります。 それが array と struct のどちらにでもとれるからです。 Zend_XmlRpc_Client は、このような状況を検出した場合にはサーバの system.methodSignature メソッドにリクエストを送り、どの XML-RPC 型に変換すべきかを判断します。
しかし、このやりかた自体にも別の問題があります。 まず、サーバが system.methodSignature をサポートしていない場合には「リクエストに失敗した」 記録がサーバに残ってしまいます。この場合、 Zend_XmlRpc_Client は値を XML-RPC の array 型に変換します。 さらに、このやりかたを使用すると 「配列形式の引数を指定してコールすると、 毎回リモートサーバへの余計な呼び出しが発生する」 ということになります。
この仕組みを無効にするには、XML-RPC コールの前に setSkipSystemLookup() メソッドをコールします。

1. $client->setSkipSystemLookup(true);
2. $result = $client->call('foo.bar', array(array()));

パラメータを表す Zend_XmlRpc_Value のインスタンスを作成し、XML-RPC の型を指定することもできます。 このようにする理由には次のようなものがあります。

• プロシージャに正しい型で渡されることを確実にしたいことがある (例えば、integer を要求しているプロシージャに対して データベースから取得した文字列を渡したい場合など)。

• プロシージャが base64 型や dateTime.iso8601 型を要求していることがある (これらは PHP のネイティブ型には存在しません)。

• 自動変換が失敗する場合 (例えば、空の XML-RPC 構造体をパラメータとして渡すことを考えましょう。 これは、PHP では空の配列に対応します。しかし、 空の配列をパラメータとして渡すと、それが自動変換されたときに XML-RPC の array になってしまいます。なぜなら、 空の配列は連想配列ではないからです)。

Zend_XmlRpc_Value オブジェクトを作成する方法は 二通りあります。Zend_XmlRpc_Value のサブクラスのインスタンスを直接作成するか、 あるいは静的ファクトリメソッド Zend_XmlRpc_Value::getXmlRpcValue() を使用します。

Zend_XmlRpc_Value オブジェクトと対応する XML-RPC 型

XML-RPC 型	対応する Zend_XmlRpc_Value 定数	Zend_XmlRpc_Value オブジェクト
int	Zend_XmlRpc_Value::XMLRPC_TYPE_INTEGER	Zend_XmlRpc_Value_Integer
i8	Zend_XmlRpc_Value::XMLRPC_TYPE_I8	Zend_XmlRpc_Value_BigInteger
ex:i8	Zend_XmlRpc_Value::XMLRPC_TYPE_APACHEI8	Zend_XmlRpc_Value_BigInteger
double	Zend_XmlRpc_Value::XMLRPC_TYPE_DOUBLE	Zend_XmlRpc_Value_Double
boolean	Zend_XmlRpc_Value::XMLRPC_TYPE_BOOLEAN	Zend_XmlRpc_Value_Boolean
string	Zend_XmlRpc_Value::XMLRPC_TYPE_STRING	Zend_XmlRpc_Value_String
nil	Zend_XmlRpc_Value::XMLRPC_TYPE_NIL	Zend_XmlRpc_Value_Nil
ex:nil	Zend_XmlRpc_Value::XMLRPC_TYPE_APACHENIL	Zend_XmlRpc_Value_Nil
base64	Zend_XmlRpc_Value::XMLRPC_TYPE_BASE64	Zend_XmlRpc_Value_Base64
dateTime.iso8601	Zend_XmlRpc_Value::XMLRPC_TYPE_DATETIME	Zend_XmlRpc_Value_DateTime
array	Zend_XmlRpc_Value::XMLRPC_TYPE_ARRAY	Zend_XmlRpc_Value_Array
struct	Zend_XmlRpc_Value::XMLRPC_TYPE_STRUCT	Zend_XmlRpc_Value_Struct

注意: 自動変換
新しい Zend_XmlRpc_Value オブジェクトを作成する際には、 その値は PHP の型として設定されます。この PHP の型は、 PHP のキャスト機能によって変換されます。 たとえば、Zend_XmlRpc_Value_Integer に文字列を渡すと、(int)$value のように変換されます。

HTTP エラーが発生した場合、 つまり、たとえばリモート HTTP サーバが 404 Not Found を返したような場合に Zend_XmlRpc_Client_HttpException がスローされます。

XML-RPC クライアントの使用法にかかわらず、HTTP エラーが発生すると必ず Zend_XmlRpc_Client_HttpException がスローされます。

XML-RPC の fault は、PHP の例外と似たものです。これは XML-RPC メソッドのコールから返される特別な型で、 エラーコードとエラーメッセージを含みます。XML-RPC の fault は、Zend_XmlRpc_Client の使用場面によって処理方法が異なります。

call() メソッドや サーバプロキシオブジェクトを使用している場合には、 XML-RPC の fault が発生すると Zend_XmlRpc_Client_FaultException がスローされます。 この例外のコードとメッセージは、もとの XML-RPC の fault レスポンスの値に対応するものとなります。

call() メソッドを使用してリクエストを作成した場合は、 fault の際に Zend_XmlRpc_Client_FaultException がスローされます。fault を含む Zend_XmlRpc_Response オブジェクトを取得するには getLastResponse() をコールします。

doRequest() メソッドでリクエストを作成した場合は、 例外はスローされません。そのかわりに、falut を含む Zend_XmlRpc_Response オブジェクトを返します。 これを調べるには、 Zend_XmlRpc_Response のインスタンスメソッド isFault() を使用します。