PHP API 框架开发的学习

基于互联网的应用正变得愈来愈普及，在这个过程当中，有更多的站点将自身的资源开放给开发者来调用。对外提供的API 调用使得站点之间的内容关联性更强，同时这些开放的平台也为用户、开发者和中小网站带来了更大的价值。

在开发API前，你须要的是给API设定一个框架，这个框架必定是要简单的且是容易扩展的。下面就是用就来看看如何使用PHP来建立一个API。

API框架须要的特性

• 面向对象和结构化的代码
• 可修改的URL结构
• 建立多个版本
• 使用Hook来扩展框架API功能
• API可链接数据库表
• 可定义多种输出格式
• 选择方法请求类型（GET, POST, PUT, DELETE）

API框架的组成部分

API Framework主要由下面三中类型元素组成：

• Services
• Hooks
• Parsers

在一个运行的API中，每种类型的元素都有其本身的任务。下面就来详细说说每一种元素。

 

一般的API请求URL以下：

http://www.domain.com/api/version/service/method/param_name/param_key.extension

Service

Service Class是API请求的控制器。这个Class包含了API可使用的method，因此Service Class会须要计算和处理数据。

为了使method能够被请求，你须要将method设置为公开（public），并为service method设置请求类型（GET, POST, PUT, DELETE）。

下面是一个Service Class的类，你能够设置默认的请求方式为GET，而且version method能够接受GET和POST请求。

PHP

<?php class MyApi_Service_Helloworld extends Api_Service_IService{ public function __construct($api){ parent::__construct($api); // Set execute request methods $this->addAllowedMethod("execute", Api_Request::METHOD_POST); $this->addAllowedMethod("version", Api_Request::METHOD_POST); $this->addAllowedMethod("version", Api_Request::METHOD_GET); } public function execute($params, $config){ $this->code = 200; return "Hello world"; } public function version($params, $config){ $this->code = 200; return "Version 1.0"; } }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

& lt ; ? php class MyApi_Service_Helloworld extends Api_Service_IService {   public function __construct ( $api ) { parent :: __construct ( $api ) ;   // Set execute request methods $this - & gt ; addAllowedMethod ( "execute" , Api_Request:: METHOD_POST ) ; $this - & gt ; addAllowedMethod ( "version" , Api_Request:: METHOD_POST ) ; $this - & gt ; addAllowedMethod ( "version" , Api_Request:: METHOD_GET ) ;   }   public function execute ( $params , $config ) { $this - & gt ; code = 200 ; return "Hello world" ; }   public function version ( $params , $config ) { $this - & gt ; code = 200 ; return "Version 1.0" ; }   }

这里是一个可使用的使用的API请求类型：

• Api_Request::METHOD_GET
• Api_Request::METHOD_POST
• Api_Request::METHOD_PUT
• Api_Request::METHOD_DELETE

若是你但愿方法（ method）名以驼峰式命名的话，如：

public myNewHelloWorld{}

那么你就须要在你的url中使用”my-new-hello-world”来请求这个方法（/v1/helloworld/my-new-hello-world.xml）。

Hook

Hook是一个能够绑定特定行为的类。哪些Hooks 会在执行力中执行特定的点（如图所示）。它可让你在服务使用前修改数据。下面是一些可能的hook示例：

• 监测用户使用的API key是否在数据库中存在。
• 监测特定的IP地址是不是容许使用服务或行为的。
• 在文件或者数据库中记录用户的请求日志。
• 禁止特定的 IP使用API。
• 限制IP每小时对API的请求数。

上面的只是一些示例，你能够发挥你的想象任意的添加Hook。下面是一个关于Hook的实例：

PHP

class Api_Hook_BlockIp extends Api_Hook_IHook { public function execute(){ // Current called service $service = func_get_arg(0); // Get config array $config = $this->api->getConfig(); // Stop if blocks is not configured if(!isset($config['block'])) return; // Convert comma separated list to array $blocked = explode(',', $config['block']); // Check if the user IP is blocked // If blocked show him a message if(in_array($_SERVER['REMOTE_ADDR'], $blocked)){     throw new Api_Error('Spammer', 'Your IP address is blocked.'); } } }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

class Api_Hook_BlockIp extends Api_Hook_IHook {   public function execute ( ) {   // Current called service $service = func_get_arg ( 0 ) ;   // Get config array $config = $this - & gt ; api - & gt ; getConfig ( ) ;   // Stop if blocks is not configured if ( ! isset ( $config [ 'block' ] ) ) return ;   // Convert comma separated list to array $blocked = explode ( ',' , $config [ 'block' ] ) ;   // Check if the user IP is blocked // If blocked show him a message if ( in_array ( $_SERVER [ 'REMOTE_ADDR' ] , $blocked ) ) {     throw new Api_Error ( 'Spammer' , 'Your IP address is blocked.' ) ; } }   }

为了使上面的Hook能够正常的工做，你须要在config文件中添加这样一行：

block = ip1,ip2,ip3

接下来就是讲解不一样种类的hook了：

• HOOK_CONFIG_LOADED: 这个hook是在加载了配置（config）请求的。他能够用来修改或添加一些配置信息
• HOOK_BEFORE_SERVICE_EXECUTE: 这个hook是在服务执行前执行的，因此它能够用来校核用户身份，查看是否有具体的权限。
• HOOK_MODIFY_PARSER: 使用这个Hook能够在输出数据解析前修改解析器。

若是要启用钩子则须要到程序的入口（endpoint.php）进行修改。

Parsers

解析器用来转化数据到特定的输出格式的。例如是XML，机械器就是用定义的APi请求文件扩展名来表示。例如：

• /v1/helloworld.xml: 则使用Xml.php做为解析器
• /v1/helloworld.json: 则使用Json.php做为解析器

你能够根据本身的需求定义标准的解析器，如：

• XML
• CSV
• JSON
• Printr
• TXT

下面是一种相似PHP中print_r的输出格式示例：

PHP

class Api_Parser_Printr extends Api_Parser_IParser{ /** * Content type * @var string */ public $content_type = "text/plain"; /** * Parse to XML * * @return string */ public function parse(){ return print_r($this->_data, true); } }

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

class Api_Parser_Printr extends Api_Parser_IParser {   /** * Content type * @var string */ public $content_type = "text/plain" ;   /** * Parse to XML * * @return string */ public function parse ( ) { return print_r ( $this - & gt ; _data , true ) ; }   }

框架会根据命名规则自动寻找适合的输出格式。

要顺利的开发一个PHP API，除了以上的这些还须要作的有：

1. 建立一个基本的API配置文件，并修改好程序的入口。
2. 配置本身想要的REST URL结构。
3. 记录接口中产生的错误。~