? ??? ??? ?????? ????? ???? ???? ?? API? ?? ??? ????? ??? ?? ?? ??? ???? ?? ??? API ??? ?? ? ??? ?????. ? ????? ThinkPHP6 ??????? API ?? ??? ???? ??? ?????.

1. ?? ??? ?? ????

?? ??? ??? ??? ?? ??? ???? ?????. API ???? ?? ??? ?? ????? API? ?? ??? ???? ??? ?? ??? ?????.

?? ???? ????? ??? ?? ??? ????.

• URL ?? ??: ??? ??? URL? ???? API ??? ?????.
• ?? ?? ??: HTTP ??? ???? API ??? ?????.
• ?? ???? ?? ??: ?? ????? ???? API ??? ?????.

ThinkPHP6??? URL ?? ??? ???? API ?? ??? ???????.

2. ?? ?? ???? ??

?? API ??? ???? ???? ????? ???? ???. ThinkPHP6??? ?? ??? ???? ????? ??? ? ????.

php think make:middleware VersionControl

?? ?? API ??? ?? handle ???? ?? ?? ??? ?????. URL ?? ??? ?? ??, URL? ???? ???? API ??? ??? ? ????. ?? ??, user API ?? 1? ?????? /v1/user? ?????. handle方法中實(shí)現(xiàn)版本控制邏輯。以URL版本控制為例，我們可以在URL中使用一個(gè)前綴來(lái)指定API版本。例如，使用/v1/user來(lái)訪問(wèn)版本1的userAPI。

中間件代碼如下所示：

<?php
declare (strict_types = 1);

namespace appmiddleware;

use thinkRequest;
use thinkResponse;

class VersionControl
{
    public function handle(Request $request, Closure $next)
    {
        $version = $request->param('version'); // 獲取版本號(hào)
        if (!$this->isValidVersion($version)) {
            $response = new Response();
            $response->code(400);
            $response->data('Invalid Version'); // 返回錯(cuò)誤響應(yīng)
            return $response;
        } else {
            // 正常請(qǐng)求
            return $next($request);
        }
    }

    private function isValidVersion($version)
    {
        // 驗(yàn)證版本號(hào)是否有效，這里可以根據(jù)自己的業(yè)務(wù)規(guī)則進(jìn)行驗(yàn)證
        switch ($version) {
            case 'v1':
            case 'v2':
                return true;
            default:
                return false;
        }
    }
}

3. 注冊(cè)版本控制中間件

中間件創(chuàng)建完成后，我們需要將其注冊(cè)到應(yīng)用中，以便對(duì)請(qǐng)求進(jìn)行攔截和處理。在應(yīng)用的middleware.php文件中添加中間件類的全名，并指定需要中間件處理的路由前綴。

return [
    'VersionControl' => ppmiddlewareVersionControl::class,
];

// 路由中間件
return [
    'api/:version/user' => 'api/:version.User/index',
    'api/:version/order' => 'api/:version.Order/index',
    'api/:version/product' => 'api/:version.Product/index',
]->middleware(['VersionControl']);

4. 實(shí)現(xiàn)版本化的API

現(xiàn)在，我們可以實(shí)現(xiàn)包含版本號(hào)的API。創(chuàng)建版本號(hào)控制器和對(duì)應(yīng)的方法，在方法中實(shí)現(xiàn)業(yè)務(wù)邏輯。

例如，在控制器apppicontroller1User.php中，我們可以實(shí)現(xiàn)API的版本控制方法：

<?php
declare (strict_types = 1);

namespace apppicontroller1;

use thinkesponseJson;

class User
{
    public function index(): Json
    {
        return json(['message' => 'This is user API V1']);
    }
}

在apppicontroller2User.php中，實(shí)現(xiàn)API版本2的控制器方法：

<?php
declare (strict_types = 1);

namespace apppicontroller2;

use thinkesponseJson;

class User
{
    public function index(): Json
    {
        return json(['message' => 'This is user API V2']);
    }
}

現(xiàn)在，我們就可以在瀏覽器中訪問(wèn)不同版本的用戶API：

• http://localhost/api/v1/user：返回{"message":"This is user API V1"}
• http://localhost/api/v2/user：返回{"message":"This is user API V2"}
???? ??? ??? ????.

?? ?? ???? ??
????? ??? ? ??? ???? ????? ??????? ???? ???. ??????? middleware.php ??? ???? ???? ?? ??? ???? ?????? ???? ?? ?? ???? ?????.

rrreee

??? ??? API ??
???? ?? ??? ??? API? ??? ? ????. ?? ?? ????? ?? ???? ??? ???? ???? ??? ?????. ?????? ?? ???? app picontroller 1User.php?? API ?? ?? ??? ??? ? ????. ??rrreee??app picontroller 2User.php?? ???? ??? ??? ????. API ?? 2 ??: ??rrreee???? ?????? ??? ??? ??? API? ???? ? ????. ??????http://localhost/api/v1/user: ? ?????. "message":"??? ??? API V1???."}????http://localhost/api/v2/user: ?? {"message":"??? ?????? API V2"}????????????????? ????? ?? URL ?? ??? ???? ?? ?????, ?? ???? ? ??? ??? API? ??? ThinkPHP6?? API ?? ??? ???? ??? ??????. ?? ??. ??????? ??: ? ??? ???? ????? ???? ?? ?? ??? ? ????. ??

? ??? ThinkPHP6?? API ?? ??? ???? ??? ??????? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!