## 6.3.1 使用說明 將框架目錄下的 ./SDK/PHP/PhalApiClient 目錄中的全部代碼拷貝到項目里面即可使用。 ## 6.3.2 代碼示例 如下是使用的代碼場景片段。 首先，我們需要導入SDK包： ```javascript <?php require_once dirname(__FILE__) . '/PhalApiClient.php'; $client = PhalApiClient::create() ->withHost('http://demo.phalapi.net/'); $rs = $client->reset() ->withService('Default.Index') ->withParams('username', 'dogstar') ->withTimeout(3000) ->request(); var_dump($rs->getRet()); echo "\n"; var_dump($rs->getData()); echo "\n"; var_dump($rs->getMsg()); ``` ## 6.3.3 運行效果 運行后，可以看到： ```javascript int(200) array(4) { ["title"]=> string(12) "Hello World!" ["content"]=> string(36) "dogstar您好，歡迎使用PhalApi！" ["version"]=> string(5) "1.2.1" ["time"]=> int(1444925238) } string(0) "" ``` ## 6.3.4 更多調用 當需要重復調用時，需要先進行 **重置操作** ，如： ```javascript //one more time $rs = $client->reset() ->withService("User.GetBaseInfo") ->withParams("user_id", "1") ->request(); var_dump($rs->getRet()); echo "\n"; var_dump($rs->getData()); echo "\n"; var_dump($rs->getMsg()); ``` 當請求有異常時，返回的 ret!= 200，如： ```javascript //illegal request $rs = $client->reset() ->withService("XXX.XXXXX") ->withParams("user_id", "1") ->request(); var_dump($rs->getRet()); echo "\n"; var_dump($rs->getData()); echo "\n"; var_dump($rs->getMsg()); ``` 以上的輸出為： ```javascript -------------------- int(200) array(3) { ["code"]=> int(0) ["msg"]=> string(0) "" ["info"]=> array(3) { ["id"]=> string(1) "1" ["name"]=> string(7) "dogstar" ["from"]=> string(7) "oschina" } } string(0) "" -------------------- int(400) array(0) { } string(45) "非法請求：接口服務XXX.XXXXX不存在" ``` ## 6.3.5 擴展你的過濾器和結果解析器 ### (1)擴展過濾器 當服務端接口需要接口簽名驗證，或者接口參數加密傳送，或者壓縮傳送時，可以實現此過濾器，以便和服務端操持一致。 當需要擴展時，分兩步。首先，需要實現過濾器接口： ```javascript <?php class MyFilter implements PhalApiClientFilter { public function filter($service, array &$params) { //TODO ... } } ``` 然后設置過濾器： ```javascript <?php $rs = PhalApiClient.create() .withHost("http://demo.phalapi.net/") .withFilter(new MyFilter()) // ... .request(); ``` ### (2)擴展結果解析器 當返回的接口結果不是JSON格式時，可以重新實現此接口。 當需要擴展時，同樣分兩步。類似過濾器擴展，這里不再贅述。