FastD 最佳實(shí)踐一: 構(gòu)建 API

WalkerXu 發(fā)布于2019-06-28 13:22 / 1835人閱讀

摘要：最佳實(shí)踐一構(gòu)建是一個(gè)專(zhuān)門(mén)針對(duì)應(yīng)用層而生的一個(gè)應(yīng)用框架，提供良好的中間件，路由以及支持?jǐn)U展運(yùn)行，從而具體良好的性能條件。手動(dòng)創(chuàng)建添加路由地址調(diào)用完成最第一個(gè)路由。緩存也是一個(gè)前置中間件，使用方式與日常操作保持一致。

FastD 最佳實(shí)踐一: 構(gòu)建 API

FastD 是一個(gè)專(zhuān)門(mén)針對(duì) API 應(yīng)用層而生的一個(gè) PHP 應(yīng)用框架，提供良好的中間件，路由以及支持 swoole 擴(kuò)展運(yùn)行，從而具體良好的性能條件。

創(chuàng)建項(xiàng)目

composer create-project fastd/dobee api -vvv

創(chuàng)建一個(gè)為 API 的項(xiàng)目。

運(yùn)行第一個(gè)程序

進(jìn)入命令行模式

php -S localhost:9876 -t web

訪(fǎng)問(wèn) localhost:9876

{
    "msg":"hello dobee"
}

執(zhí)行流程

點(diǎn)擊: FastD設(shè)計(jì)詳解

實(shí)現(xiàn)第一個(gè)路由

1. 創(chuàng)建"控制器"

通過(guò)命令行

php bin/console controller:create {name}

命令行會(huì)自動(dòng)創(chuàng)建 CURD 多個(gè)操作方法，由開(kāi)發(fā)者手動(dòng)添加操作邏輯。

手動(dòng)創(chuàng)建

MeController.php

 "janhuang"
        ]);
    }
}

2. 添加路由地址

get("/", "WelcomeController@welcome");
route()->get("/hello/{name}", "WelcomeController@sayHello");
route()->get("/who", "MeController@me");

3. 調(diào)用

curl -i http://127.0.0.1:9876/who

response

{
    "name": "janhuang"
}

完成最第一個(gè)路由。

給應(yīng)用添加單元測(cè)試

我仍熱認(rèn)為測(cè)試是一個(gè)非常重要的環(huán)節(jié)，也是一個(gè)優(yōu)秀開(kāi)發(fā)者一個(gè)重要品質(zhì)之一。

如果其中涉及數(shù)據(jù)庫(kù)測(cè)試，可以參考: 數(shù)據(jù)庫(kù)測(cè)試

request("GET", "/");
        $response = $this->app->handleRequest($request);
        $this->isSuccessful($response);
    }
}

可以給你的應(yīng)用API添加格式各樣的測(cè)試，來(lái)驗(yàn)證程序的有效性。

給 API 添加公共緩存

何為公共緩存？

公共緩存的靈感來(lái)自于 varnish，當(dāng)用戶(hù)發(fā)起非 GET 請(qǐng)求的時(shí)候，進(jìn)行緩存處理并返回(如果有的話(huà))，其他請(qǐng)求一律穿透，交給底層處理。

緩存也是一個(gè)前置中間件，使用方式與日常操作保持一致。

文檔: 中間件

config/app.php

 [
        // code
        "common.cache" => [FastDMiddlewareCacheMiddleware::class]
    ],
];

config/routes.php

get("/", "WelcomeController@welcome");
route()->get("/hello/{name}", "WelcomeController@sayHello");
route()->get("/who", "MeController@me")->withMiddleware("common.cache");

完成配置后，請(qǐng)求路由地址

curl -i http://localhost:9876/who

HTTP/1.1 200
Host: localhost:9876
Connection: close
X-Powered-By: PHP/7.0.0
Content-Type: application/json; charset=UTF-8
X-Cache: ee4d94f352cb03116b61ce9158720ebf
Expires: Tue, 08 Aug 2017 10:58:21 GMT

會(huì)產(chǎn)生 X-Cache 新的響應(yīng)頭，用于代表緩存生效。

Basic Auth

大部分 API 中，都需要對(duì)請(qǐng)求來(lái)源進(jìn)行一定的鑒權(quán)處理，由于框架已經(jīng)集成了簡(jiǎn)單的 Basic auth，使用方法與上述保持一致。

get("/", "WelcomeController@welcome");
route()->get("/hello/{name}", "WelcomeController@sayHello");
route()->get("/who", "MeController@me")->withMiddleware(["basic.auth", "common.cache"]);

為 API Server 加速

眾所周知，swoole 為 PHP 提供了良好的性能體驗(yàn)和網(wǎng)絡(luò)通信體驗(yàn)，而框架中也無(wú)縫整合 swoole，為框架、服務(wù)提供良好體驗(yàn)做了一個(gè)鋪墊，現(xiàn)在，你只需要配置IP、端口、swoole常用配置，即可無(wú)痕啟動(dòng)以 swoole 服務(wù)器，為你的 API Server 進(jìn)行加速處理。

config/server.php


 * @copyright 2016
 *
 * @link      https://www.github.com/janhuang
 * @link      http://www.fast-d.cn/
 */

return [
    "host" => "http://".get_local_ip().":9527",
    "class" => FastDServitizationServerHTTPServer::class,
    "options" => [
        "user" => "nobody",
        "group" => "nogroup",
        "pid_file" => __DIR__ . "/../runtime/pid/" . app()->getName() . ".pid",
        "log_file" => __DIR__ . "/../runtime/logs/" . app()->getName() . ".pid",
        "log_level" => 5,
        "worker_num" => 10,
        "task_worker_num" => 20,
    ],
    "processes" => [

    ],
    "listeners" => [

    ],
];

get_local_ip 函數(shù)為了默認(rèn)或者本地內(nèi)網(wǎng)ip，如果你的API是對(duì)外開(kāi)放的，請(qǐng)修改為您的外網(wǎng)ip或者 0.0.0.0。

options 參數(shù)為 swoole 擴(kuò)展配置參數(shù)。請(qǐng)參考: swoole配置

啟動(dòng)

php bin/server start

守護(hù)進(jìn)程

php bin/server start -d

停止

php bin/server stop

云服務(wù)器 GPU云服務(wù)器 api設(shè)計(jì)的最佳實(shí)踐最佳實(shí)踐 webrtc最佳實(shí)踐 cdn最佳實(shí)踐

文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址：http://m.hztianpu.com/yun/25611.html

發(fā)表評(píng)論

登陸后可評(píng)論

0條評(píng)論

WalkerXu

男|高級(jí)講師

我要關(guān)注我要私信

TA的文章

Nextarray：美國(guó)vps/達(dá)拉斯vps，2核/1GB內(nèi)存/20GB SSD/不限流量/100M

閱讀 1089·2021-10-19 11:42
渾渾噩噩10年，入坑軟件測(cè)試，6年干到測(cè)試leader，非科班的我也能當(dāng)程序員！

閱讀 3061·2021-09-10 10:51
什么是接口測(cè)試？接口測(cè)試基礎(chǔ)、案例及Json格式詳解

閱讀 758·2021-09-09 09:33
#消息#Sharktech：推出云托管服務(wù)，聯(lián)系客服可獲得$50，白嫖一個(gè)月4核/8G的服務(wù)器

閱讀 1835·2021-09-01 10:43
Web前端工程師應(yīng)該懂的的知識(shí)點(diǎn)——HTML/CSS

閱讀 2834·2019-08-30 12:43
css偽類(lèi)選擇器

閱讀 3574·2019-08-30 11:24
CSS 深入理解：overflow: hidden——隱藏溢出、清除浮動(dòng)、解除坍塌

閱讀 2278·2019-08-30 10:56
DIV 上下左右居中黑科技

閱讀 2831·2019-08-29 11:00

成人无码视频,亚洲精品久久久久av无码,午夜精品久久久久久毛片,亚洲中文字幕日韩无码

資訊專(zhuān)欄INFORMATION COLUMN

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！

FastD 最佳實(shí)踐一: 構(gòu)建 API

1. 創(chuàng)建"控制器"

2. 添加路由地址

3. 調(diào)用

啟動(dòng)

守護(hù)進(jìn)程

停止

相關(guān)文章

FastD 最佳實(shí)踐三: 構(gòu)建API網(wǎng)關(guān)

FastD 最佳實(shí)踐五: 構(gòu)建ELK日志分析

FastD 最佳實(shí)踐二: 構(gòu)建配置中心

FastD 最佳實(shí)踐四: 構(gòu)建系統(tǒng)可視化監(jiān)控

FastD 最佳實(shí)踐六: 為應(yīng)用添加調(diào)用鏈監(jiān)控 Zipkin

發(fā)表評(píng)論

0條評(píng)論

WalkerXu

男|高級(jí)講師

TA的文章

Nextarray：美國(guó)vps/達(dá)拉斯vps，2核/1GB內(nèi)存/20GB SSD/不限流量/100M

渾渾噩噩10年，入坑軟件測(cè)試，6年干到測(cè)試leader，非科班的我也能當(dāng)程序員！

什么是接口測(cè)試？接口測(cè)試基礎(chǔ)、案例及Json格式詳解

#消息#Sharktech：推出云托管服務(wù)，聯(lián)系客服可獲得$50，白嫖一個(gè)月4核/8G的服務(wù)器

Web前端工程師應(yīng)該懂的的知識(shí)點(diǎn)——HTML/CSS

css偽類(lèi)選擇器

CSS 深入理解：overflow: hidden——隱藏溢出、清除浮動(dòng)、解除坍塌

DIV 上下左右居中黑科技

最新活動(dòng)

資訊專(zhuān)欄INFORMATION COLUMN

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！

FastD 最佳實(shí)踐一: 構(gòu)建 API

1. 創(chuàng)建"控制器"

2. 添加路由地址

3. 調(diào)用

啟動(dòng)

守護(hù)進(jìn)程

停止

相關(guān)文章

發(fā)表評(píng)論

0條評(píng)論

男|高級(jí)講師

TA的文章

最新活動(dòng)

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！