# 前言
*****
### 在使用<code>Thinkphp</code>接口开发项目的程中可能会遇到这样的场景
+ 准备将原有系统重构一遍，但是出于某种原因，老的系统在未来一段时间内必须和新的版本共存；
+ APP存在老版本不能强制升级，所以服务端接口需要同时兼容新老客户端同时正常使用；
+ 其他更多需要新老兼容的场景
如果只是在一套接口中做特殊判断，将会变得非常难维护。所以更好的方法是进行版本管理。本文主要分享通过URL路由方式来达到版本控制。
在实际的开发中不同的版本方法名基本上都是一样的。以用户注册接口为例，
方法名都是： <code>register</code>
>[success] 两个版本通过以下url访问，URL格式：域名/模块名/版本号/控制器/方法名
```
v1版本：http://www.tp5.com/api/v1/user/register
v2版本：http://www.tp5.com/api/v2/user/register
```
首先我们在<code>route.php</code>文件中定义好路由规则
```php
<?php
return [
'api/:version/:controller/:function' => 'api/:version.:controller/:function',
];
```
接下来看一下目录结构
其中 <code>application/api/controller/v1/User.php</code> 中文件代码如下
```php
<?php
namespace app\api\controller\v1;
class User
{
public function register()
{
dump('我是v1版本的register方法');
}
}
```
其中 <code>application/api/controller/v2/User.php</code> 中文件代码如下
```php
<?php
namespace app\api\controller\v2;
class User
{
public function register()
{
dump('我是v2版本的register方法');
}
}
```
## 接下来我们使用postman工具模拟请求 v1和v2版本的url
### v1版本http://www.tp5.com/api/v1/user/register
### v2版本http://www.tp5.com/api/v2/user/register
至此，已经完成了最简单的通过thinkphp5路由规则实现API的版本控制，是不是非常简单呢？
> 其他API版本控制的思路
+ 通过域名路由 <code>v1.api.tp5.com</code> <code>v2.api.tp5.com</code> 在<code>route.php</code>中获取对应版本标识并路由到应控制器文件中
+ 在header中传入<code>version</code>参数，并<code>route.php</code>中获取对应值再路由对应控制器文件中
+ 直接将版本号作为参数传入进行路由~
实际上thinkphp的路由规则远比想象的要强大灵活很多，建议多阅读官方ThinkPHP5.1完全开发手册之路由篇 https://www.kancloud.cn/manual/thinkphp5_1/353960 ，希望大家可以结合自己的业务场景充分利用路由的功能让URL更规范以及优雅，也可隐式传入额外请求参数，让自己的系统更加安全，优雅！
## 开发帮助及交流
如您对本文感兴趣想与我联系交流 您可以
+ 邮件至：xieyongfa@ecarde.cn
+ QQ：2392523899 [点我聊天](http://wpa.qq.com/msgrd?v=3&uin=2392523899&site=qq&menu=yes&from=message&isappinstalled=0)
+ 微信交流
