使用PHP创建一个REST API(Create a REST API with PHP) 节选3

Getting Started with REST and PHP 开始使用PHP写REST


One last disclaimer: the code we’re about to go over is in no way intended to be used as an example of a robust solution. My main goal here is to show how to deal with the individual components of REST in PHP, and leave creating the final solution up to you. 
最后一项免责声明：我们接下来提供的代码并不能被用来作为一个稳健的解决方案。我的主要目的是向大家展示如果使用PHP处理REST的每个单独部分，而把最后的解决方案留给你们自己去创建。


So, let’s dig in! I think the best way to do something practical is to create a class that will provide all the utility functions we need to create a REST API. We’ll also create a small class for storing our data. You could also then take this, extend it, and apply it to your own needs. So, let’s stub some stuff out: 
那么，让我们开始深入代码。我认为做一个实际事情做好的方法就是新建一个class，这个class将提供创建REST API所需要的所有功能性方法。现在我们新建一个小的class来存储我们的数据。你可以把它拿去扩展一下然后应用到自己的需求中。我们现在开始写点东西：

PHP代码 

1. class RestUtils
2. {
3.   public static function processRequest(){
5.   }
7.   public static function sendResponse($status = 200, $body = '', $content_type = 'text/html'){
9.   }
11.   public static function getStatusCodeMessage($status){
12.     // these could be stored in a .ini file and loaded
13.     // via parse_ini_file()... however, this will suffice
14.     // for an example
15.     // 这些应该被存储在一个.ini的文件中，然后通过parse_ini_file()函数来解析出来，然而这样也足够了，比如：
16.     $codes = Array(
17.       100 => 'Continue',
18.       101 => 'Switching Protocols',
19.       200 => 'OK',
20.       201 => 'Created',
21.       202 => 'Accepted',
22.       203 => 'Non-Authoritative Information',
23.       204 => 'No Content',
24.       205 => 'Reset Content',
25.       206 => 'Partial Content',
26.       300 => 'Multiple Choices',
27.       301 => 'Moved Permanently',
28.       302 => 'Found',
29.       303 => 'See Other',
30.       304 => 'Not Modified',
31.       305 => 'Use Proxy',
32.       306 => '(Unused)',
33.       307 => 'Temporary Redirect',
34.       400 => 'Bad Request',
35.       401 => 'Unauthorized',
36.       402 => 'Payment Required',
37.       403 => 'Forbidden',
38.       404 => 'Not Found',
39.       405 => 'Method Not Allowed',
40.       406 => 'Not Acceptable',
41.       407 => 'Proxy Authentication Required',
42.       408 => 'Request Timeout',
43.       409 => 'Conflict',
44.       410 => 'Gone',
45.       411 => 'Length Required',
46.       412 => 'Precondition Failed',
47.       413 => 'Request Entity Too Large',
48.       414 => 'Request-URI Too Long',
49.       415 => 'Unsupported Media Type',
50.       416 => 'Requested Range Not Satisfiable',
51.       417 => 'Expectation Failed',
52.       500 => 'Internal Server Error',
53.       501 => 'Not Implemented',
54.       502 => 'Bad Gateway',
55.       503 => 'Service Unavailable',
56.       504 => 'Gateway Timeout',
57.       505 => 'HTTP Version Not Supported'
58.     );
60.     return (isset($codes[$status])) ? $codes[$status] : '';
61.   }
62. }
64. class RestRequest
65. {
66.   private $request_vars;
67.   private $data;
68.   private $http_accept;
69.   private $method;
71.   public function __construct(){
72.     $this->request_vars    = array();
73.     $this->data        = '';
74.     $this->http_accept    = (strpos($_SERVER['HTTP_ACCEPT'], 'json')) ? 'json' : 'xml';
75.     $this->method      = 'get';
76.   }
78.   public function setData($data){
79.     $this->data = $data;
80.   }
82.   public function setMethod($method){
83.     $this->method = $method;
84.   }
86.   public function setRequestVars($request_vars){
87.     $this->request_vars = $request_vars;
88.   }
90.   public function getData(){
91.     return $this->data;
92.   }
94.   public function getMethod(){
95.     return $this->method;
96.   }
98.   public function getHttpAccept(){
99.     return $this->http_accept;
100.   }
102.   public function getRequestVars(){
103.     return $this->request_vars;
104.   }
105. }

OK, so what we’ve got is a simple class for storing some information about our request (RestRequest), and a class with some static functions we can use to deal with requests and responses. As you can see, we really only have two functions to write… which is the beauty of this whole thing! Right, let’s move on… 
Processing the Request 
好，现在我们有了一个简单的class来存储request的一些信息（RestRequest），和一个提供几个静态方法的class来处理请求和响应。就像你能看到的，我们还有两个方法要去写，这才是整个代码的关键所在，让我们继续...


Processing the request is pretty straight-forward, but this is where we can run into a few catches (namely with PUT and DELETE… mostly PUT). We’ll go over those in a moment, but let’s examine the RestRequest class a bit. If you’ll look at the constructor, you’ll see that we’re already interpreting the HTTP_ACCEPT header, and defaulting to JSON if none is provided. With that out of the way, we need only deal with the incoming data. 

处理请求的过程非常直接，但是这才是我们可以有所收获的地方（即PUT/DELETE，大多数是PUT），我们接下来将会讨论这些。但是让我们先来检查一下RestRequest这个class，在构造方法中，你会看到我们已经处理了HTTP_ACCEPT的头信息，并且将JSON作为默认值。这样，我们就只需要处理传入的数据。

目录：

使用PHP创建一个REST API(Createa REST API with PHP) 节选1

使用PHP创建一个REST API(Createa REST API with PHP) 节选2

使用PHP创建一个REST API(Createa REST API with PHP) 节选3

使用PHP创建一个REST API(Create aREST API with PHP) 节选4

使用PHP创建一个REST API(Createa REST API with PHP) 节选5

使用PHP创建一个REST API(Createa REST API with PHP) 节选6