HTTP客戶端庫

為了體驗不同的請求方法，你在客戶端需要一個支援改變請求型別的東東。不幸的是，HTTP的表單時不行的，他只能傳送GET和POST請求，真實的情況下，你可以通過一些獨立的客戶端應用程式或者javascript來完成。

在服務端程式設計之外，選擇一個好的HTTP客戶端程式語言是非常重要的。

最流行的客戶端程式就是cURL了，在上篇中我們也有講到一些簡單的命令列應用。cURL有一個獨立可執行的命令列端，也有適合各個程式的庫。通常，cURL用來在PHP中處理HTTP請求。其他的語言，比如python，有自己原生支援的東西。

開始一個例子

我們的PHP程式很簡單。我不從框架的角度來談，只是從最基本的一些功能來講述。我也不想用一些真實存在的API，比如twitter的，他經常會變化，而且也需要驗證，這樣就不能馬上用了，所以。

執行這些例項，你需要安裝PHP5，然後讓本地伺服器跑起來。也必須在5.2版本之上，這樣才有json_encode()和json_decode()函式可用。

對於伺服器端，最方便的當然還是Apache+php_mod，當然你也可以用其他的你更加熟悉的伺服器端程式。這裡還有一些轉發規則，可以讓你的應用更快的跑起來。

所有URL是/client開頭的請求都需要轉發到server.php檔案。

在Apache中，你需要啟動mod_rewrite模組，然後修改相應的配置，或者修改你的.htacess檔案。這樣server.php才能接受到所有的請求，如果你用ngnix也需要同樣的配置。

範例程式是如何工作的？

將請求用REST的方法處理有兩個關鍵點：
第一，根據HTTP請求的不同初始化不同的處理程式–即使都是同一個URL，在PHP中，有在global中有一個$_SERVER變數，可以決定使用哪種方法來發起請求。

1

$_SERVER['REQUEST_METHOD']

這個變數中的請求型別以字串形式儲存，比如’GET’,'POST’。

第二個關鍵點在於需要知道是那個URL，我們也可以使用PHP的全域性變數。

1

$_SERVER['REQUEST_URI']

這個變數包含URL中第一個/開始後面的部分(http://不算)，假如主機名是’example.com’,那麼’http://example.com/’就會返回’/'，’http://example.com/test/’就會返回’/test/’。

所以在這裡我們只考慮以’client’開始URL，其他的忽略：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

        $resource = array_shift($paths);
 
        if ($resource == 'clients') {
            $name = array_shift($paths);
 
            if (empty($name)) {
                $this->handle_base($method);
            } else {
                $this->handle_name($method, $name);
            }
 
        } else {
            // We only handle resources under 'clients'
            header('HTTP/1.1 404 Not Found');
        }

我們會有兩種輸出：

• 是clients資源，我們返回完整的列表
• 更多的校驗

如果還有更多的校驗項，我們假設是客戶名，當然，還需要根據方法的不同進行不同的處理，我們使用switch來做判斷：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

switch($method) {
        case 'PUT':
            $this->create_contact($name);
            break;
 
        case 'DELETE':
            $this->delete_contact($name);
            break;
 
        case 'GET':
            $this->display_contact($name);
            break;
 
        default:
            header('HTTP/1.1 405 Method Not Allowed');
            header('Allow: GET, PUT, DELETE');
            break;
        }

返回狀態碼

你可能注意到了，在這個例子中，使用了PHP的header()方法來處理一些奇怪的東西。header()方法用來輸出HTTP頭部資訊，並且保證相應的值是按照規範來的。頭部資訊是需要首先輸出的，所以在你做完頭部資訊處理之前不要輸出別的東西。有的時候，伺服器需要增加一些自定義的頭部資訊，這在程式碼中要註明。

heaer資訊包含一些列的東西，比如文字的編碼方式，內容元素的MIME資訊。這裡，還有HTTP的返回狀態碼。狀態碼是用來告訴客戶端這次請求的返回狀態的。通常200表示一切正常。

伺服器端應該返回最合適的狀態碼，這樣客戶端才能做相應的處理。很多對404很熟悉，當然，還有很多其他的狀態碼。

需要注意的是，這些狀態碼也不是非常的準確，這是HTTP本身的原因造成的。你應該嘗試使用最接近現實的狀態碼，但是也不用太擔心。

下面這些狀態碼，在REST中也很常用：

200 OK

表示一切正常。

201 Created

表示資源成功建立，通常是對PUT和POST請求的返回。

400 Bad Request

通常在PUT和POST請求中，表示資料沒有通過驗證等情況。

401 Unauthorized

這個返回表示要訪問的資源需要授權。

405 Method Not Allowed

這個資源不支援這種HTTP方法。

409 Conflict

表示衝突。例如你使用了兩次PUT請求建立一個資源。

500 Internal Server Error

伺服器的內部錯誤。

例項程式實戰

我們來做幾個簡單的操作來看看，我們現在要獲取jim這個客戶的資訊，所以我們發起一個GET請求：

1

curl -v http://localhost:80/clients/jim

這會顯示完整的資訊頭部。最後一行會顯示內容。在這個例子中，將會是一個包含jim的地址的JSON物件。

下面，我們還可以一次請求所有的客戶資訊：

1

curl -v http://localhost:80/clients/

還可以建立一個客戶：

1

curl -v -X PUT http://localhost:80/clients/paul -d '{"address":"Sunset Boulevard" }

然後你會得到一個包含Paul的所有客戶的列表。

最後，刪除一個客戶：

1

curl -v -X DELETE http://localhost:80/clients/anne

這時候就看不到anne的客戶資訊了。

如果你想要讀取一個不存在的客戶資訊，那麼將會返回404錯誤。如果要建立一個已經存在的客戶，那麼會返回409錯誤。

總結

需要重點記住的是，HTTP是用來給兩個沒有任何共享資源的系統通訊用的。通常，超越HTTP的部分越少，你的應用就更加易於在多個系統間執行。

使用PHP因為大家也都算熟悉。實際上，雖然PHP是WEB語言，他也不是做REST最佳選擇，比如他處理PUT的辦法就跟GET和POST很不同。最佳的PHP REST庫在Zend Framework中有。

除了PHP，你還有很多其他的選擇：

• 很多ruby框架（Rails和Sinata）
• Python中對REST的支援也不錯

refer