php 创建简单的Restful WebAPI（二）

　　先说一下这个项目的代码结构吧。

　　首先是index.php，我是把它作为中央控制器，一个调度器。程序通过rewrite或其他方式，把所有url导向本文件，由index.php调度其他代码。

　　然后route.php，用设置好的路由规则匹配当前的url，来选择响应的controller（下面解释）来处理request，返回response。

　　request.php，本文件用来解析requset信息（头部信息：method，accept，querystring，请求body的数据（主要为json格式）等），保存到内存里等待其他程序使用。

　　response.php，本文件用来生成response信息（body数据（json格式），设置状态码，content-type等），返回给客户端。

　　controller文件夹内的文件，这些文件用来处理具体业务逻辑，根据request.php，操作数据库，使用response.php生成结果返回给客户端。

　　db.php由名字可知，本文件为数据库操作类(mysql)。

　　还有其他类如日志功能，身份验证等等以后再实现吧。

　　Rewite

　　应用程序首先将所有url导向到index.php。可以使用Apache服务器mod_rewrite重写转向（Rewrite）模块来实现。由于我的web服务搭建在新浪SAE,它本身的config.yaml具有url重写功能，只需要加入一句 - rewrite: if(!is_file()) goto "index.php?%{QUERY_STRING}" 就可以了（config.yaml配置可参阅SAE相关文档）。

　　Route

　　首先在router.php配置相关规则：

<?php
/**
 *路由配置文件编写说明：
 *  路由配置在一个array数组中，一条记录代表一个规则
 *  优先匹配索引低的规则
 *  key:   只接受2中规则 ‘/{controller}‘和‘/{controller}/{id}‘。{controller}可用字符包括：字母，数字，_
 *  value: 第一项controller类名(文件名除去扩展名必须与类名相同);
 *         第二项id只能为正整数(包含0)
 *  controller文件必须位于‘/controller‘文件夹下；类名必须与文件名相同(除去扩展名.php)，区分大小写。
**/
$routes= array(
    ‘/resources‘ => array(‘resources‘,‘‘),
    ‘/resources/id‘ => array(‘resources‘,‘id‘),
);
?>

　　routes数组保存应用程序的相关规则，由于时间紧迫，设置规则十分不灵活，后期需要加以修改，规则及其解析我们都可以随时进行调整。routes数组key为需要匹配的url，value为响应的controller名字。前文我们有提到，我们只需要处理2种url ：‘/resources‘ => array(‘resources‘,‘‘)表示匹配到/resources时，选择controller文件下的resources.php文件内的resources类来处理。‘/resources/id‘ => array(‘resources‘,‘id‘)，大同小异，只不过我们需要，匹配并保存url中第二层的id。

　　然后route.php解析上面的规则:

<?php

class Route
{
    private $filepath;
    private $classname;
    private $id;
    private $routepatterns; 

    public function __construct()
    {
        $this->filepath      = ‘‘;
        $this->classname     = ‘‘;
        $this->id            = null;
        $this->routepatterns = array();
        $this->initRoutes();
    }

    private function initRoutes()
    {
        $reg_m1 = ‘#^/(\w+)$#‘;
        $reg_m2 = ‘#^/(\w+)/id$#‘;
        $matches = array();
        $routes = array();
        include ‘router.php‘;
        foreach($routes as $key=>$value){  

            if(preg_match($reg_m1,$key,$matches)){
                $this->routepatterns[] = array(‘#^/(‘.$matches[1].‘)\??$#i‘, array(‘controller/‘.$value[0].‘.php‘,$value[0]));
            }
            else if(preg_match($reg_m2,$key,$matches)){
                $this->routepatterns[] = array(‘#^/(‘.$matches[1].‘)/(\d+)\??$#i‘, array(‘controller/‘.$value[0].‘.php‘,$value[0]));
            }
        }
    }

    public function processURL($urlpath)
    {
        $matches = array();
        foreach($this->routepatterns as $router){
             if(preg_match($router[0],$urlpath,$matches)){
                 $filepath_ = ‘/‘.$router[1][0];
                 $classname_ = $router[1][1];
                 $id_ = count($matches)>2?$matches[2]:null;
                 $this->setFilePath($filepath_);
                 $this->setClassName($classname_);
                 $this->setID($id_);
                 return true;
             }
         }
         return false;
    }

    public function setFilePath($filepath)
    {
        $this->filepath = $filepath;
    }  

    public function setClassName($classname)
    {
        $this->classname = $classname;
    }  

    public function setID($id)
    {
        $this->id = $id;
    }  

    public function getFilePath()
    {
        return $this->filepath;
    }  

    public function getClassName()
    {
        return $this->classname;
    }  

    public function getID()
    {
        return $this->id;
    }  

}

?>

　　方法initRoutes()解析了routes所有规则，保存routepatterns中，等待使用。processURL($urlpath)方法使用解析出的routepatterns匹配传入url，获取相应的结果，并记录下来。