首页 > 代码库 > php 创建简单的Restful WebAPI(二)
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解析上面的规则:
<?phpclass 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,获取相应的结果,并记录下来。
php 创建简单的Restful WebAPI(二)