r-labs

redmine.org の "Rest_api_with_php":http://www.redmine.org/projects/redmine/wiki/Rest_api_with_php の日本語訳です。

h1. PHP での REST API の使用法

PHP には "PHP ActiveResource":http://wiki.github.com/lux/phpactiveresource/ という Rails の REST API を使用するための軽量なライブラリがあります。

以下にその使用例を記述します。

<pre>

<code class="php">

<?php

require_once ('ActiveResource.php');

class Issue extends ActiveResource {

    var $site = 'http://username:password@192.168.199.129:3000/';

    var $request_format = 'xml'; // REQUIRED!

}

// チケットの作成

$issue = new Issue (array ('subject' => 'XML REST API', 'project_id' => '1'));

$issue->save ();

echo $issue->id;

// チケットの取得

$issues = $issue->find ('all');

for ($i=0; $i < count($issues); $i++) {

	echo $issues[$i]->subject;

}

// ID で指定したチケットの取得と更新

$issue->find (1);

echo $issue->subject;

$issue->set ('subject', 'This is the new subject')->save ();

// チケットの削除

$issue->find (1);

$issue->destroy ();

?>

</code>

</pre>

*既知の問題*

* かなり長い"説明"が記述されている場合には、 WEB サーバーは 417(Bad Expectation) エラーを返す可能性があります。

_ActiveResource.php_ の 381 行目を次のように書き直して下さい。

<pre><code class="php">curl_setopt ($ch, CURLOPT_HTTPHEADER, array ('Expect:',"Content-Type: text/xml", "Length: " . strlen ($params)));</code></pre>

訳注: もう一つ不具合の対処法が記述されていましたが、今リリースされている ActiveResource.php のバージョンでは対応済みのようなので、翻訳していません。