ThinkPHP5 RESTful API开发版本控制

thinkphp5 RESTful api开发版本控制,thinkphp官方文档不是很详细,我根据个人经验分享下。

我们以一个用户信息读取的接口为例,包含两个版本V1和V2,v2版本的接口包括用户的档案信息,统一使用json格式数据输出到客户端。

在application目录下面创建api模块目录,并创建controller和model子目录,因为api接口无需视图,所以不需要创建view目录。

api版本号可以在请求头、参数、URL路由参数中传入,以下是tp5.X中使用方法。

第一种:URL路由传入方式(推荐)

在route.php路由文件中配置,如下

return [  
    // api版本路由  
    'api/:version/:controller'=>'api/:version.:controller/index',// 省略方法名时  
    'api/:version/:controller/:function'=>'api/:version.:controller/:function'// 有方法名时  

];  

不同版本的URL访问地址为:

http://tp5.com/api/v1/user/10
http://tp5.com/api/v2/user/10

版本号中不能包含.符号。

第二种:请求头传入方式

在route.php路由文件中配置,如下

$v = request()->header('version');  
if($v==null) $v = "v1";  
return [  

    //api版本控制  
    'api/:controller$'=>['api/'.$v.'.:controller/index',['method' => 'get']],  
    'api/:controller/:function$'=>'api/'.$v.'.:controller/:function',  

    //资源路由  
    '__rest__'=>[  
        //api  
        'api/house'=>['api/'.$v.'.house',['only'=>['index','read','update','delete']]],  
        'api/book'=>['api/'.$v.'.book',['only'=>['index','read','save','delete']]],  
        'api/book_rent'=>['api/'.$v.'.book_rent',['only'=>['index','read','save']]],  
  ]  
]  

第三种:请求参数传入方式

和请求头方式类似,这里不再累述。

控制器实现

v1版本控制器(类文件位置为application/api/controller/v1/User.php)代码如下:

namespace app\api\controller\v1;

use app\api\model\User as UserModel;

class User
{
    // 获取用户信息
    public function read($id = 0)
    {
        $user = UserModel::get($id);
        if ($user) {
            return json($user);
        } else {
            return json(['error' => '用户不存在'], 404);
        }
    }

}

v2版本的控制器(类文件位置为application/api/controller/v2/User.php)代码如下:

namespace app\api\controller\v2;

use app\api\model\User as UserModel;

class User
{
// 获取用户信息
public function read(id = 0)  
    {
id = 0)      {
user = UserModel::get(id,profile);if(id,‘profile′);if(user) {
return json($user);
} else {
return json([‘error’ => ‘用户不存在’], 404);
}
}

}

你可能感兴趣的:(php)