資料介紹
軟件簡(jiǎn)介
Vega 是一個(gè)用 PHP 編寫(xiě)的 CLI 模式 HTTP 網(wǎng)絡(luò)框架,支持 Swoole、WorkerMan、FPM、CLI-Server
概述
Vega 是?MixPHP?V3+
?內(nèi)置的最核心的組件 (可獨(dú)立使用),參考 golang?gin?mux?開(kāi)發(fā),它包含 Web 應(yīng)用處理的大量功能 (數(shù)據(jù)庫(kù)處理除外) ,包括:路由、渲染、參數(shù)獲取、中間件、文件上傳、靜態(tài)文件處理等;具有 CLI 模式下強(qiáng)大的兼容性,同時(shí)支持 Swoole、WorkerMan、FPM、CLI-Server, 并且支持 Swoole 的多種進(jìn)程模型與協(xié)程。
推薦搭配以下數(shù)據(jù)庫(kù)使用:
- https://github.com/mix-php/database
- https://github.com/mix-php/redis
- https://github.com/top-think/think-orm
- https://github.com/illuminate/database
推薦文章:
技術(shù)交流
知乎:https://www.zhihu.com/people/onanying
官方QQ群:284806582?,?825122875?敲門暗號(hào):vega
安裝
composer require mix/vega
快速開(kāi)始
- Swoole 多進(jìn)程 (異步) 中使用
require __DIR__ . '/vendor/autoload.php'; $vega = new Mix\Vega\Engine(); $vega->handle('/hello', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET'); $http = new Swoole\Http\Server('0.0.0.0', 9501); $http->on('Request', $vega->handler()); $http->set([ 'worker_num' => 4, ]); $http->start();
開(kāi)啟多進(jìn)程協(xié)程
$http->on('Request', $vega->handler()); $http->on('WorkerStart', function ($server, $workerId) { // 協(xié)程初始化 // 比如:?jiǎn)?dòng) mix/database mix/redis 的連接池 }); $http->set([ 'enable_coroutine' => true, 'worker_num' => 4, ]);
php swoole.php
- Swoole 單進(jìn)程 (協(xié)程) 中使用
require __DIR__ . '/vendor/autoload.php'; Swoole\Coroutine\run(function () { $vega = new Mix\Vega\Engine(); $vega->handle('/hello', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET'); $server = new Swoole\Coroutine\Http\Server('0.0.0.0', 9502, false); $server->handle('/', $vega->handler()); $server->start(); });
php swooleco.php
- WorkerMan 中使用
require __DIR__ . '/vendor/autoload.php'; $vega = new Mix\Vega\Engine(); $vega->handle('/hello', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET'); $http_worker = new Workerman\Worker("http://0.0.0.0:2345"); $http_worker->onMessage = $vega->handler(); $http_worker->count = 4; Workerman\Worker::runAll();
php wokerman.php start
- PHP-FPM 中使用
在?nginx
?配置?rewrite
?重寫(xiě)到?index.php
require __DIR__ . '/vendor/autoload.php'; $vega = new Mix\Vega\Engine(); $vega->handle('/hello', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET'); return $vega->run();
- PHP?cli-server?中使用
這個(gè)內(nèi)置的Web服務(wù)器主要用于本地開(kāi)發(fā)使用,不可用于線上產(chǎn)品環(huán)境。
require __DIR__ . '/vendor/autoload.php'; $vega = new Mix\Vega\Engine(); $vega->handle('/hello', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET'); return $vega->run();
php -S localhost:8000 router.php
- 訪問(wèn)測(cè)試
% curl http://127.0.0.1:9501/hello hello, world!
路由配置
配置?Closure
?閉包路由
$vega = new Mix\Vega\Engine(); $vega->handle('/hello', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET');
配置?callable
?路由
class Hello { public function index(Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); } } $vega = new Mix\Vega\Engine(); $vega->handle('/hello', [new Hello(), 'index'])->methods('GET');
配置路由變量
$vega = new Mix\Vega\Engine(); $vega->handle('/users/{id:\d+}', function (Mix\Vega\Context $ctx) { $id = $ctx->param('id'); $ctx->string(200, 'hello, world!'); })->methods('GET');
配置多個(gè)?method
$vega = new Mix\Vega\Engine(); $vega->handle('/hello', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET', 'POST');
路由前綴 (分組)
$vega = new Mix\Vega\Engine(); $sub = $vega->pathPrefix('/foo'); $sub->handle('/bar1', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET'); $sub->handle('/bar2', function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello1, world!'); })->methods('GET');
參數(shù)獲取
請(qǐng)求參數(shù)
方法名稱 | 描述 |
---|---|
$ctx->request: ServerRequestInterface | 符合PSR的請(qǐng)求對(duì)象 |
$ctx->response: ResponseInterface | 符合PSR的響應(yīng)對(duì)象 |
ctx?>param(stringctx?>param(stringkey): string | 獲取路由參數(shù) |
ctx?>query(stringctx?>query(stringkey): string | 獲取url參數(shù),包含路由參數(shù) |
ctx?>defaultQuery(stringctx?>defaultQuery(stringkey, string $default): string | 獲取url參數(shù),可配置默認(rèn)值 |
ctx?>getQuery(stringctx?>getQuery(stringkey): string or null | 獲取url參數(shù), 可判斷是否存在 |
ctx?>postForm(stringctx?>postForm(stringkey): string | 獲取post參數(shù) |
ctx?>defaultPostForm(stringctx?>defaultPostForm(stringkey, string $default): string | 獲取post參數(shù),可配置默認(rèn)值 |
ctx?>getPostForm(stringctx?>getPostForm(stringkey): string or null | 獲取post參數(shù),可判斷是否存在 |
Headers, Cookies, Uri ...
方法名稱 | 描述 |
---|---|
$ctx->contentType(): string | 請(qǐng)求類型 |
ctx?>header(stringctx?>header(stringkey): string | 請(qǐng)求頭 |
ctx?>cookie(stringctx?>cookie(stringname): string | cookies |
$ctx->uri(): UriInterface | 完整uri |
$ctx->rawData(): string | 原始包數(shù)據(jù) |
客戶端IP
方法名稱 | 描述 |
---|---|
$ctx->clientIP(): string | 從反向代理獲取用戶真實(shí)IP |
$ctx->remoteIP(): string | 獲取遠(yuǎn)程IP |
上傳文件處理
方法名稱 | 描述 |
---|---|
ctx?>formFile(stringctx?>formFile(stringname): UploadedFileInterface | 獲取上傳的第一個(gè)文件 |
$ctx->multipartForm(): UploadedFileInterface[] | 獲取上傳的全部文件 |
文件保存
$file = $ctx->formFile('img'); $targetPath = '/data/project/public/uploads/' . $file->getClientFilename(); $file->moveTo($targetPath);
請(qǐng)求上下文
請(qǐng)求當(dāng)中需要保存一些信息,比如:會(huì)話、JWT載荷等。
方法名稱 | 描述 |
---|---|
ctx?>set(stringctx?>set(stringkey, $value): void | 設(shè)置值 |
ctx?>get(stringctx?>get(stringkey): mixed or null | 獲取值 |
ctx?>mustGet(stringctx?>mustGet(stringkey): mixed or throws | 獲取值或拋出異常 |
中斷執(zhí)行
abort
?執(zhí)行后,會(huì)停止執(zhí)行后面的全部代碼,包括中間件。
方法名稱 | 描述 |
---|---|
$ctx->abort(): void | 中斷,需自行處理響應(yīng) |
ctx?>abortWithStatus(intctx?>abortWithStatus(intcode): void | 中斷并響應(yīng)狀態(tài)碼 |
ctx?>abortWithStatusJSON(intctx?>abortWithStatusJSON(intcode, $data): void | 中斷并響應(yīng)JSON |
$vega = new Mix\Vega\Engine(); $vega->handle('/users/{id}', function (Mix\Vega\Context $ctx) { if (true) { $ctx->string(401, 'Unauthorized'); $ctx->abort(); } $ctx->string(200, 'hello, world!'); })->methods('GET');
響應(yīng)處理
方法名稱 | 描述 |
---|---|
ctx?>status(intctx?>status(intcode): void | 設(shè)置狀態(tài)碼 |
ctx?>setHeader(stringctx?>setHeader(stringkey, string $value): void | 設(shè)置header |
ctx?>setCookie(stringctx?>setCookie(stringname, string?value,intvalue,intexpire = 0, ...): void | 設(shè)置cookie |
ctx?>redirect(stringctx?>redirect(stringlocation, int $code = 302): void | 重定向 |
JSON 請(qǐng)求與輸出
獲取 JSON 請(qǐng)求數(shù)據(jù)
$vega = new Mix\Vega\Engine(); $vega->handle('/users', function (Mix\Vega\Context $ctx) { $obj = $ctx->getJSON(); if (!$obj) { throw new \Exception('Parameter error'); } var_dump($obj); $ctx->JSON(200, [ 'code' => 0, 'message' => 'ok' ]); })->methods('POST');
mustGetJSON
?自帶有效性檢查,以下代碼等同于上面
$vega = new Mix\Vega\Engine(); $vega->handle('/users', function (Mix\Vega\Context $ctx) { $obj = $ctx->mustGetJSON(); var_dump($obj); $ctx->JSON(200, [ 'code' => 0, 'message' => 'ok' ]); })->methods('POST');
JSONP 處理
$vega = new Mix\Vega\Engine(); $vega->handle('/jsonp', function (Mix\Vega\Context $ctx) { $ctx->JSONP(200, [ 'code' => 0, 'message' => 'ok' ]); })->methods('GET');
HTML 視圖渲染
創(chuàng)建視圖文件?foo.php
id: = $id ?>, name: = $name ?> friends:foreach($friends as $name): ?> = $name ?> endforeach; ?>
配置視圖路徑,并響應(yīng)html
$vega = new Mix\Vega\Engine(); $vega->withHTMLRoot('/data/project/views'); $vega->handle('/html', function (Mix\Vega\Context $ctx) { $ctx->HTML(200, 'foo', [ 'id' => 1000, 'name' => '小明', 'friends' => [ '小花', '小紅' ] ]); })->methods('GET');
靜態(tài)文件處理
基于?sendfile
?零拷貝,不支持在?PHP-FPM
?中使用
$vega = new Mix\Vega\Engine(); $vega->static('/static', '/data/project/public/static'); $vega->staticFile('/favicon.ico', '/data/project/public/favicon.ico');
設(shè)置中間件
給某個(gè)路由配置中間件,可配置多個(gè)
$vega = new Mix\Vega\Engine(); $func = function (Mix\Vega\Context $ctx) { // do something $ctx->next(); }; $vega->handle('/hello', $func, function (Mix\Vega\Context $ctx) { $ctx->string(200, 'hello, world!'); })->methods('GET');
配置全局中間件,即便沒(méi)有匹配到路由也會(huì)執(zhí)行
$vega = new Mix\Vega\Engine(); $vega->use(function (Mix\Vega\Context $ctx) { $ctx->next(); });
前置中間件
$vega->use(function (Mix\Vega\Context $ctx) { // do something $ctx->next(); });
后置中間件
$vega->use(function (Mix\Vega\Context $ctx) { $ctx->next(); // do something });
404 自定義
$vega = new Mix\Vega\Engine(); $vega->use(function (Mix\Vega\Context $ctx) { try{ $ctx->next(); } catch (Mix\Vega\Exception\NotFoundException $ex) { $ctx->string(404, 'New 404 response'); $ctx->abort(); } });
500 全局異常捕獲
$vega = new Mix\Vega\Engine(); $vega->use(function (Mix\Vega\Context $ctx) { try{ $ctx->next(); } catch (\Throwable $ex) { if ($ex instanceof Mix\Vega\Abort || $ex instanceof Mix\Vega\Exception\NotFoundException) { throw $ex; } $ctx->string(500, 'New 500 response'); $ctx->abort(); } });
License
Apache License Version 2.0,?http://www.apache.org/licenses/
- ChatGPT:AI模型框架研究 1次下載
- MA5680T設(shè)備CLI的基本操作 4次下載
- ani-cli瀏覽和觀看動(dòng)漫的cli
- OpenHarmony上使用的Http網(wǎng)絡(luò)框架教程 4次下載
- 智能Mesh IP V經(jīng)理CLI指南
- 基于情感評(píng)分的分層注意力網(wǎng)絡(luò)框架 5次下載
- 智能Mesh Web HART經(jīng)理CLI指南
- SmartMesh IP Embedded Manager CLI指南
- SmartMesh IP Mote CLI指南
- SmartMesh WirelessHart Mote CLI指南
- 基于時(shí)間卷積網(wǎng)絡(luò)的通用日志序列異常檢測(cè)框架 8次下載
- Navicat for MySQL如何才能設(shè)置HTTP屬性 6次下載
- 網(wǎng)絡(luò)資源分配框架的軟件設(shè)計(jì)和應(yīng)用 10次下載
- SmartMesh WirelessHART經(jīng)理CLI指南 0次下載
- 基于攻擊事件的動(dòng)態(tài)網(wǎng)絡(luò)風(fēng)險(xiǎn)評(píng)估框架 0次下載
- 高性能網(wǎng)絡(luò)框架之XDP技術(shù)解析 3206次閱讀
- 如何使用 ESP-AT實(shí)現(xiàn)HTTP請(qǐng)求 1065次閱讀
- 簡(jiǎn)化網(wǎng)絡(luò)自動(dòng)化任務(wù)編排框架Nornir的用法 1932次閱讀
- 大話HTTP協(xié)議前世今生 607次閱讀
- Http是什么 4914次閱讀
- STM32G0開(kāi)發(fā)筆記:FreeRTOS和CLI組件使用 3065次閱讀
- JustWeEngine游戲框架網(wǎng)絡(luò)事件處理 Http服務(wù)器的數(shù)據(jù)交換 1632次閱讀
- 詳解Netty高性能異步事件驅(qū)動(dòng)的網(wǎng)絡(luò)框架 1707次閱讀
- 鴻蒙環(huán)境下的Http網(wǎng)絡(luò)訪問(wèn)完成設(shè)計(jì) 1663次閱讀
- Linux操作系統(tǒng)解讀:GUI、CLI 和 TUI 3675次閱讀
- 如何發(fā)起 HTTP 請(qǐng)求流程 4827次閱讀
- 基于TensorFlow框架搭建卷積神經(jīng)網(wǎng)絡(luò)的電池片缺陷識(shí)別研究 7617次閱讀
- HTTP協(xié)議的使用方式和設(shè)計(jì)原理講解 4113次閱讀
- 基于Simplicity Studio的 CLI便捷地調(diào)試Zigbee網(wǎng)絡(luò) 9185次閱讀
- OMCS網(wǎng)絡(luò)語(yǔ)音視頻聊天框架功能及技術(shù)分析 2560次閱讀
下載排行
本周
- 1山景DSP芯片AP8248A2數(shù)據(jù)手冊(cè)
- 1.06 MB | 532次下載 | 免費(fèi)
- 2RK3399完整板原理圖(支持平板,盒子VR)
- 3.28 MB | 339次下載 | 免費(fèi)
- 3TC358743XBG評(píng)估板參考手冊(cè)
- 1.36 MB | 330次下載 | 免費(fèi)
- 4DFM軟件使用教程
- 0.84 MB | 295次下載 | 免費(fèi)
- 5元宇宙深度解析—未來(lái)的未來(lái)-風(fēng)口還是泡沫
- 6.40 MB | 227次下載 | 免費(fèi)
- 6迪文DGUS開(kāi)發(fā)指南
- 31.67 MB | 194次下載 | 免費(fèi)
- 7元宇宙底層硬件系列報(bào)告
- 13.42 MB | 182次下載 | 免費(fèi)
- 8FP5207XR-G1中文應(yīng)用手冊(cè)
- 1.09 MB | 178次下載 | 免費(fèi)
本月
- 1OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234315次下載 | 免費(fèi)
- 2555集成電路應(yīng)用800例(新編版)
- 0.00 MB | 33566次下載 | 免費(fèi)
- 3接口電路圖大全
- 未知 | 30323次下載 | 免費(fèi)
- 4開(kāi)關(guān)電源設(shè)計(jì)實(shí)例指南
- 未知 | 21549次下載 | 免費(fèi)
- 5電氣工程師手冊(cè)免費(fèi)下載(新編第二版pdf電子書(shū))
- 0.00 MB | 15349次下載 | 免費(fèi)
- 6數(shù)字電路基礎(chǔ)pdf(下載)
- 未知 | 13750次下載 | 免費(fèi)
- 7電子制作實(shí)例集錦 下載
- 未知 | 8113次下載 | 免費(fèi)
- 8《LED驅(qū)動(dòng)電路設(shè)計(jì)》 溫德?tīng)栔?/a>
- 0.00 MB | 6656次下載 | 免費(fèi)
總榜
- 1matlab軟件下載入口
- 未知 | 935054次下載 | 免費(fèi)
- 2protel99se軟件下載(可英文版轉(zhuǎn)中文版)
- 78.1 MB | 537798次下載 | 免費(fèi)
- 3MATLAB 7.1 下載 (含軟件介紹)
- 未知 | 420027次下載 | 免費(fèi)
- 4OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234315次下載 | 免費(fèi)
- 5Altium DXP2002下載入口
- 未知 | 233046次下載 | 免費(fèi)
- 6電路仿真軟件multisim 10.0免費(fèi)下載
- 340992 | 191187次下載 | 免費(fèi)
- 7十天學(xué)會(huì)AVR單片機(jī)與C語(yǔ)言視頻教程 下載
- 158M | 183279次下載 | 免費(fèi)
- 8proe5.0野火版下載(中文版免費(fèi)下載)
- 未知 | 138040次下載 | 免費(fèi)
評(píng)論
查看更多