資料介紹
軟件簡介
Vega 是一個用 PHP 編寫的 CLI 模式 HTTP 網絡框架,支持 Swoole、WorkerMan、FPM、CLI-Server
概述
Vega 是?MixPHP?V3+
?內置的最核心的組件 (可獨立使用),參考 golang?gin?mux?開發,它包含 Web 應用處理的大量功能 (數據庫處理除外) ,包括:路由、渲染、參數獲取、中間件、文件上傳、靜態文件處理等;具有 CLI 模式下強大的兼容性,同時支持 Swoole、WorkerMan、FPM、CLI-Server, 并且支持 Swoole 的多種進程模型與協程。
推薦搭配以下數據庫使用:
- https://github.com/mix-php/database
- https://github.com/mix-php/redis
- https://github.com/top-think/think-orm
- https://github.com/illuminate/database
推薦文章:
技術交流
知乎:https://www.zhihu.com/people/onanying
官方QQ群:284806582?,?825122875?敲門暗號:vega
安裝
composer require mix/vega
快速開始
- Swoole 多進程 (異步) 中使用
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();
開啟多進程協程
$http->on('Request', $vega->handler()); $http->on('WorkerStart', function ($server, $workerId) { // 協程初始化 // 比如:啟動 mix/database mix/redis 的連接池 }); $http->set([ 'enable_coroutine' => true, 'worker_num' => 4, ]);
php swoole.php
- Swoole 單進程 (協程) 中使用
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
?重寫到?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?中使用
這個內置的Web服務器主要用于本地開發使用,不可用于線上產品環境。
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
- 訪問測試
% 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');
配置多個?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');
參數獲取
請求參數
方法名稱 | 描述 |
---|---|
$ctx->request: ServerRequestInterface | 符合PSR的請求對象 |
$ctx->response: ResponseInterface | 符合PSR的響應對象 |
ctx?>param(stringctx?>param(stringkey): string | 獲取路由參數 |
ctx?>query(stringctx?>query(stringkey): string | 獲取url參數,包含路由參數 |
ctx?>defaultQuery(stringctx?>defaultQuery(stringkey, string $default): string | 獲取url參數,可配置默認值 |
ctx?>getQuery(stringctx?>getQuery(stringkey): string or null | 獲取url參數, 可判斷是否存在 |
ctx?>postForm(stringctx?>postForm(stringkey): string | 獲取post參數 |
ctx?>defaultPostForm(stringctx?>defaultPostForm(stringkey, string $default): string | 獲取post參數,可配置默認值 |
ctx?>getPostForm(stringctx?>getPostForm(stringkey): string or null | 獲取post參數,可判斷是否存在 |
Headers, Cookies, Uri ...
方法名稱 | 描述 |
---|---|
$ctx->contentType(): string | 請求類型 |
ctx?>header(stringctx?>header(stringkey): string | 請求頭 |
ctx?>cookie(stringctx?>cookie(stringname): string | cookies |
$ctx->uri(): UriInterface | 完整uri |
$ctx->rawData(): string | 原始包數據 |
客戶端IP
方法名稱 | 描述 |
---|---|
$ctx->clientIP(): string | 從反向代理獲取用戶真實IP |
$ctx->remoteIP(): string | 獲取遠程IP |
上傳文件處理
方法名稱 | 描述 |
---|---|
ctx?>formFile(stringctx?>formFile(stringname): UploadedFileInterface | 獲取上傳的第一個文件 |
$ctx->multipartForm(): UploadedFileInterface[] | 獲取上傳的全部文件 |
文件保存
$file = $ctx->formFile('img'); $targetPath = '/data/project/public/uploads/' . $file->getClientFilename(); $file->moveTo($targetPath);
請求上下文
請求當中需要保存一些信息,比如:會話、JWT載荷等。
方法名稱 | 描述 |
---|---|
ctx?>set(stringctx?>set(stringkey, $value): void | 設置值 |
ctx?>get(stringctx?>get(stringkey): mixed or null | 獲取值 |
ctx?>mustGet(stringctx?>mustGet(stringkey): mixed or throws | 獲取值或拋出異常 |
中斷執行
abort
?執行后,會停止執行后面的全部代碼,包括中間件。
方法名稱 | 描述 |
---|---|
$ctx->abort(): void | 中斷,需自行處理響應 |
ctx?>abortWithStatus(intctx?>abortWithStatus(intcode): void | 中斷并響應狀態碼 |
ctx?>abortWithStatusJSON(intctx?>abortWithStatusJSON(intcode, $data): void | 中斷并響應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');
響應處理
方法名稱 | 描述 |
---|---|
ctx?>status(intctx?>status(intcode): void | 設置狀態碼 |
ctx?>setHeader(stringctx?>setHeader(stringkey, string $value): void | 設置header |
ctx?>setCookie(stringctx?>setCookie(stringname, string?value,intvalue,intexpire = 0, ...): void | 設置cookie |
ctx?>redirect(stringctx?>redirect(stringlocation, int $code = 302): void | 重定向 |
JSON 請求與輸出
獲取 JSON 請求數據
$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 視圖渲染
創建視圖文件?foo.php
id: = $id ?>, name: = $name ?> friends:foreach($friends as $name): ?> = $name ?> endforeach; ?>
配置視圖路徑,并響應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');
靜態文件處理
基于?sendfile
?零拷貝,不支持在?PHP-FPM
?中使用
$vega = new Mix\Vega\Engine(); $vega->static('/static', '/data/project/public/static'); $vega->staticFile('/favicon.ico', '/data/project/public/favicon.ico');
設置中間件
給某個路由配置中間件,可配置多個
$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');
配置全局中間件,即便沒有匹配到路由也會執行
$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設備CLI的基本操作 4次下載
- ani-cli瀏覽和觀看動漫的cli
- OpenHarmony上使用的Http網絡框架教程 4次下載
- 智能Mesh IP V經理CLI指南
- 基于情感評分的分層注意力網絡框架 5次下載
- 智能Mesh Web HART經理CLI指南
- SmartMesh IP Embedded Manager CLI指南
- SmartMesh IP Mote CLI指南
- SmartMesh WirelessHart Mote CLI指南
- 基于時間卷積網絡的通用日志序列異常檢測框架 8次下載
- Navicat for MySQL如何才能設置HTTP屬性 6次下載
- 網絡資源分配框架的軟件設計和應用 10次下載
- SmartMesh WirelessHART經理CLI指南 0次下載
- 基于攻擊事件的動態網絡風險評估框架 0次下載
- 高性能網絡框架之XDP技術解析 3206次閱讀
- 如何使用 ESP-AT實現HTTP請求 1065次閱讀
- 簡化網絡自動化任務編排框架Nornir的用法 1932次閱讀
- 大話HTTP協議前世今生 607次閱讀
- Http是什么 4914次閱讀
- STM32G0開發筆記:FreeRTOS和CLI組件使用 3065次閱讀
- JustWeEngine游戲框架網絡事件處理 Http服務器的數據交換 1632次閱讀
- 詳解Netty高性能異步事件驅動的網絡框架 1707次閱讀
- 鴻蒙環境下的Http網絡訪問完成設計 1663次閱讀
- Linux操作系統解讀:GUI、CLI 和 TUI 3675次閱讀
- 如何發起 HTTP 請求流程 4827次閱讀
- 基于TensorFlow框架搭建卷積神經網絡的電池片缺陷識別研究 7617次閱讀
- HTTP協議的使用方式和設計原理講解 4113次閱讀
- 基于Simplicity Studio的 CLI便捷地調試Zigbee網絡 9185次閱讀
- OMCS網絡語音視頻聊天框架功能及技術分析 2560次閱讀
下載排行
本周
- 1山景DSP芯片AP8248A2數據手冊
- 1.06 MB | 532次下載 | 免費
- 2RK3399完整板原理圖(支持平板,盒子VR)
- 3.28 MB | 339次下載 | 免費
- 3TC358743XBG評估板參考手冊
- 1.36 MB | 330次下載 | 免費
- 4DFM軟件使用教程
- 0.84 MB | 295次下載 | 免費
- 5元宇宙深度解析—未來的未來-風口還是泡沫
- 6.40 MB | 227次下載 | 免費
- 6迪文DGUS開發指南
- 31.67 MB | 194次下載 | 免費
- 7元宇宙底層硬件系列報告
- 13.42 MB | 182次下載 | 免費
- 8FP5207XR-G1中文應用手冊
- 1.09 MB | 178次下載 | 免費
本月
- 1OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234315次下載 | 免費
- 2555集成電路應用800例(新編版)
- 0.00 MB | 33566次下載 | 免費
- 3接口電路圖大全
- 未知 | 30323次下載 | 免費
- 4開關電源設計實例指南
- 未知 | 21549次下載 | 免費
- 5電氣工程師手冊免費下載(新編第二版pdf電子書)
- 0.00 MB | 15349次下載 | 免費
- 6數字電路基礎pdf(下載)
- 未知 | 13750次下載 | 免費
- 7電子制作實例集錦 下載
- 未知 | 8113次下載 | 免費
- 8《LED驅動電路設計》 溫德爾著
- 0.00 MB | 6656次下載 | 免費
總榜
- 1matlab軟件下載入口
- 未知 | 935054次下載 | 免費
- 2protel99se軟件下載(可英文版轉中文版)
- 78.1 MB | 537798次下載 | 免費
- 3MATLAB 7.1 下載 (含軟件介紹)
- 未知 | 420027次下載 | 免費
- 4OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234315次下載 | 免費
- 5Altium DXP2002下載入口
- 未知 | 233046次下載 | 免費
- 6電路仿真軟件multisim 10.0免費下載
- 340992 | 191187次下載 | 免費
- 7十天學會AVR單片機與C語言視頻教程 下載
- 158M | 183279次下載 | 免費
- 8proe5.0野火版下載(中文版免費下載)
- 未知 | 138040次下載 | 免費
評論
查看更多