论PHP接口版本控制【兼容多端接口】

推荐：《PHP视频教程》

在对接第三方接口的时候，总是会看到接口后缀会带着v1,v2这样的标识，我们知道这些都是接口版本的概念，那么如果我方需要提供对外的接口，或者对接web端和APP端的时候，希望公用同一个接口，但是接口所渲染的数据表现形式不太一致，以及接口授权也不太一致的情况下，如何做到使用不同版本，且不同版本直接互不影响且同时共存呢？

首先笔者在考虑到接口设计时，有几大模块：

• 控制器层(controller)：笔者将其定义为入口层(相当于java的DAO层)

• 服务层(services)：逻辑服务层，控制器入口层通过版本号标识转接到不同的服务层，具体的代码逻辑实现都在此处编写

• 行为层(behavior):也可理解为事件层，服务中间件，行为钩子都将在此处控制，入口权限过滤校验，对接第三方服务扩展通过行为钩子抽出，不让其加大服务层的代码臃肿

• 模型层(model)：该层根据实际业务和开发习惯而定，可要可不要

• 校验层(validate)：笔者认为很有必要，所有独立拉出一个目录来做相关校验，不管是独立校验，校验引擎，还是框架自带校验都在该目录定义，方便维护和扩展

• 公共层(common)：系统公共代码，比如附件上传，下载等

• 配置层(config)：内部配置，根据需求自定义是否需要

• 语言包(lang)：根据需求而定

• 复用层(tarITs)：根据实际需求而定

• 任务层(job)：根据实际需求而定

目录层级如图所示：

那么在入口层如何转接到服务层呢？因为在这过程我们会将接口中的版本号转接到不同的版本服务层。
首先在控制器入口层写一个基类控制器，后续所有的控制器都将会继承该类，在构造函数中调取行为类中的解析服务层代码，将服务层类初始化给基类变量！

    public $service = null;
    /**     * 构造函数处理头部请求     *     * @return void     */    public function __construct($tyPE = 0, Request $request)    {
        // 登录跳过        if (!$type) {
                // 注册行为监听            Hook::add('app_init', [                // 校验请求接口的身份(身份验证)                'app\\saas\\behavior\\AuthToken'            ]);
                Hook::listen('app_init', []);
        }
            // 立即执行初始化控制器服务应用        $this->
    service = Hook::exec('app\\saas\\behavior\\InitializtionService', ['tag' =>
     $type, 'request' =>
     $request]);
    }
    

服务InitializtionService解析路由，判断，将服务层实例化

    public function run($params)    {
            // 兼容控制器分层,优化控制器目录结构        $controller = request()->
    controller();
            $controllerArray = explode('.', $controller);
            $controllerLength = count($controllerArray);
            $appendControllerName = '';
        if ($controllerLength == 1) {
                $appendControllerName = $controllerArray[0];
        }
 else {
                for ($i = 0;
     $i  $controllerLength - 1;
 $i++) {
                    $appendControllerName .= strtolower($controllerArray[$i]) . '\\';
            }
                $appendControllerName .= ucFirst($controllerArray[($controllerLength - 1)]);
        }
            // $controller =  '\\app\\saas\\controller\\' . request()->
    controller();
            $controller =  '\\app\\saas\\controller\\' . $appendControllerName;
            $verion = request()->
    param('version');
        $init_service = function () use ($controller, $verion, $params) {
                // dump($controller);
                // $controller = '\app\saas\controller\test\Test';
                $reflection = new \ReflectionClass($controller);
                if (PRoperty_exists($controller, 'versions')                &
    &
     isset($reflection->
getstaticProperties()['versions'][$verion])            ) {
                    // 默认规则返回，在前在后不允许返回其他信息                $service = $reflection->
    getStaticProperties()['versions'][$verion];
                    // 判断控制器服务文件是否存在                return class_exists($service) ? new $service($params['tag'], $params['request']) : Merror::getInstance()->
    jsonApi(40006);
            }
 else {
                    Merror::getInstance()->
    jsonApi(40001);
            }
        }
    ;
            return is_null($verion) ? Merror::getInstance()->
    jsonApi(40002) : $init_service();
    }
    

这样在控制器中文件定义如下调用服务层逻辑代码，而不用关心是属于哪个服务层类，服务层代码只和版本有关

 class Sysorder extends Saas {
        /**     * 版本服务调度属性--必须默认一个且是v1     *     * @VAR     array     */    protected static $versions = [        'v1' =>
     \app\saas\services\syscenter\Sysorder::class,    ];
    /**     * 获取信息集权限目录     *     * @method  POST|GET     * @name    getSubMenuListCate     */    public function getSubMenuListCate()    {
            return json($this->
    service->
    getSubMenuListCate());
    }
    /**     * 获取列表     *     * @method  POST|GET     * @name    getSysOrderList     */    public function getSysOrderList()    {
            return json($this->
    service->
    getSysOrderList());
    }
    

结语：此设计抛砖引玉，具体实现看各位phper大显神通了！
api多版本接口设计模式，可以参考(基于ThinkPhp5.1实现，框架不同，设计理念一致)：www.kancloud.cn/lijianlin/ethantp5...
最后推广一下笔者自研的一套基于laravel设计的工作流流程引擎(https://learnku.COM/laravel/t/48967)，欢迎研究自研！

注：我这个设计主要是为了多版本接口开发的一种设计而已，每个人都有自己的开发习惯，不予强制，只是以便代码的维护和阅读！仅此建议而已

以上就是论PHP接口版本控制【兼容多端接口】的详细内容，更多请关注其它相关文章！

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！