后端微服務(wù)【免費(fèi)下載鏈接】hyperf A coroutine framework that focuses on hyperspeed and flexibility. Building microservice or middleware with ease.項(xiàng)目地址https://gitcode.com/gh_mirrors/hy/hyperf點(diǎn)擊查看免費(fèi)下載Hyperf 的hyperf/view組件為基于 Swoole 常駐內(nèi)存的協(xié)程框架提供了統(tǒng)一的視圖渲染能力它不綁定任何單一模板引擎而是通過(guò)EngineInterface抽象出可插拔的引擎層官方同時(shí)支持 Blade、Smarty、Twig、Plates 與 ThinkTemplate 五種主流模板引擎并提供 Task 與 Sync 兩種渲染模式。讀完本文你將掌握如何安裝并發(fā)布 View 組件配置、如何理解并選擇 Task/Sync 渲染模式、如何為五種引擎安裝依賴并完成配置以及如何通過(guò)實(shí)現(xiàn)EngineInterface接入任意自定義模板引擎并在控制器中完成視圖渲染。組件定位與渲染流程視圖渲染由 hyperf/view 組件實(shí)現(xiàn)。從源碼結(jié)構(gòu)看該組件包含三層核心內(nèi)容引擎抽象層EngineInterface 定義了所有模板引擎的統(tǒng)一入口render(string $template, array $data, array $config): string渲染調(diào)度層Render.php 負(fù)責(zé)根據(jù)配置的mode決定在協(xié)程內(nèi)直接渲染Sync還是投遞到 Task Worker 渲染Task并把渲染結(jié)果包裝成 PSR-7ResponseInterface引擎實(shí)現(xiàn)層Engine/目錄下提供了 Blade、Smarty、Twig、Plates、Think 五種官方引擎及一個(gè)占位引擎NoneEngine。一次典型的請(qǐng)求渲染鏈路是控制器注入RenderInterface→ 調(diào)用render($template, $data)→Render按模式調(diào)度引擎 → 引擎把模板文件渲染為字符串 → 包裝進(jìn)SwooleStream并設(shè)置content-type響應(yīng)頭后返回。安裝通過(guò) Composer 安裝組件本體composer require hyperf/view需要特別注意的是安裝hyperf/view并不會(huì)自動(dòng)安裝任何模板引擎模板引擎需要在使用時(shí)另行安裝見(jiàn)下文渲染引擎一節(jié)。組件自帶的NoneEngine只是一個(gè)占位引擎用于在沒(méi)有安裝任何模板引擎時(shí)輸出提示頁(yè)面。配置發(fā)布配置文件組件的配置文件位于config/autoload/view.php。如果該文件不存在可以執(zhí)行以下命令生成php bin/hyperf.php vendor:publish hyperf/view該發(fā)布動(dòng)作在源碼中由 ConfigProvider.php 定義publish節(jié)點(diǎn)將組件內(nèi)的 publish/view.php 復(fù)制到項(xiàng)目BASE_PATH . /config/autoload/view.php同時(shí)dependencies節(jié)點(diǎn)把RenderInterface::class綁定到Render::class這也是控制器里可以直接注入RenderInterface的原因。配置項(xiàng)說(shuō)明配置項(xiàng)類型默認(rèn)值說(shuō)明enginestringHyperf\View\Engine\BladeEngine::class視圖渲染引擎類modestringMode::TASK視圖渲染模式config.view_pathstring無(wú)視圖文件默認(rèn)地址config.cache_pathstring無(wú)視圖文件緩存地址說(shuō)明文檔表格給出的engine默認(rèn)值是 BladeEngine但組件內(nèi)置的 publish/view.php 實(shí)際發(fā)布的默認(rèn)配置為engine NoneEngine::class、mode Mode::SYNC表示組件默認(rèn)處于未安裝模板引擎的占位狀態(tài)正式使用時(shí)你需要顯式把engine改為所選引擎類。Render.php 中view.engine的兜底默認(rèn)值同樣是NoneEngine::class且若容器中不存在該引擎類會(huì)拋出EngineNotFindException。配置文件的完整示例格式?php declare(strict_types1); use Hyperf\View\Mode; use Hyperf\View\Engine\BladeEngine; return [ // 使用的渲染引擎 engine BladeEngine::class, // 不填寫(xiě)時(shí)默認(rèn)為 Task 模式建議使用 Task 模式 mode Mode::TASK, config [ // 若以下文件夾不存在請(qǐng)自行創(chuàng)建 view_path BASE_PATH./storage/view/, cache_path BASE_PATH./runtime/view/, ], ];其中view_path是模板文件的存放目錄cache_path是編譯/緩存產(chǎn)物目錄Blade 編譯后的 PHP 文件、Smarty 編譯文件、Twig 緩存均寫(xiě)入此處這兩個(gè)目錄需要提前創(chuàng)建。Task 模式使用Task模式時(shí)必須滿足兩個(gè)前置條件安裝 hyperf/task 組件將 Task 的task_enable_coroutine配置為false否則會(huì)出現(xiàn)協(xié)程數(shù)據(jù)一致性問(wèn)題。可參考 task 組件文檔。從 Render.php 的實(shí)現(xiàn)可以看到 Task 模式的實(shí)際調(diào)度方式Render會(huì)從容器中取出TaskExecutor然后構(gòu)造一個(gè)new Task([$this-engine, render], [$template, $data, $this-config])投遞給 Task Worker 執(zhí)行即引擎的render方法運(yùn)行在獨(dú)立的 Task Worker 進(jìn)程中。這帶來(lái)一個(gè)重要的使用約束Task 模式下視圖渲染工作由Task Worker 進(jìn)程完成而控制器中的請(qǐng)求處理由Worker 進(jìn)程完成因此在視圖中無(wú)法直接訪問(wèn)依賴請(qǐng)求上下文的數(shù)據(jù)對(duì)象如Request、Session。如果視圖確實(shí)需要上下文相關(guān)的數(shù)據(jù)必須在控制器中通過(guò)render方法的第二個(gè)參數(shù)把這些數(shù)據(jù)顯式傳遞進(jìn)來(lái)。Sync 模式Sync模式下Render.php 直接從容器取出引擎實(shí)例并在當(dāng)前協(xié)程內(nèi)同步調(diào)用$engine-render(...)不再經(jīng)過(guò) Task 投遞。此時(shí)必須保證所選的模板引擎是協(xié)程安全的否則同樣會(huì)產(chǎn)生數(shù)據(jù)一致性問(wèn)題。官方文檔的建議是優(yōu)先使用數(shù)據(jù)一致性更有保障的Task模式不過(guò) view-engine 組件文檔 也指出hyperf/view-engine基于 Laravel Blade 重寫(xiě)的引擎推薦使用SYNC模式可以顯著減少進(jìn)程間通信帶來(lái)的性能損耗——實(shí)際選擇取決于所用引擎的協(xié)程安全性。Mode類在源碼中定義了兩個(gè)常量Mode.phppublic const TASK task; public const SYNC sync;配置靜態(tài)資源如果希望由 Swoole 直接托管靜態(tài)資源如 CSS、JS、圖片需要在config/autoload/server.php中添加如下配置return [ settings [ ... // 靜態(tài)資源根目錄 document_root BASE_PATH./public, // 開(kāi)啟靜態(tài)資源處理 enable_static_handler true, ], ];視圖渲染引擎組件官方支持的渲染引擎有五種Blade、Smarty、Twig、Plates、ThinkTemplate。再次強(qiáng)調(diào)安裝hyperf/view后模板引擎不會(huì)自動(dòng)安裝需要按需額外安裝對(duì)應(yīng)依賴。安裝 Blade 引擎推薦方案Laravel Blade 語(yǔ)法兼容性最好并由官方維護(hù)composer require hyperf/view-engine詳細(xì)用法可參考 view engine 文檔。備選方案不推薦duncan3dc/blade使用了 Laravel 的 Support 庫(kù)部分函數(shù)會(huì)不兼容官方暫不建議使用。composer require duncan3dc/blade安裝 Smarty 引擎composer require smarty/smarty從 SmartyEngine.php 的實(shí)現(xiàn)可以看到Smarty 引擎會(huì)把view_path設(shè)置為模板目錄、cache_path同時(shí)作為緩存目錄與編譯目錄并將$data中的每個(gè)鍵值通過(guò)assign注入后執(zhí)行fetch。安裝 Twig 引擎composer require twig/twigTwigEngine.php 使用FilesystemLoader加載view_path下的模板并把cache_path傳給Environment作為緩存目錄它還支持一個(gè)額外的template_suffix配置項(xiàng)用于拼接模板文件后綴。安裝 Plates 引擎composer require league/platesPlatesEngine.php 默認(rèn)以php作為模板文件擴(kuò)展名也可以通過(guò)config.file_extension配置項(xiàng)覆蓋。安裝 ThinkTemplate 引擎composer require sy-records/think-templateThinkEngine.php 會(huì)直接把整個(gè)$config數(shù)組傳給think\Template構(gòu)造器因此 ThinkTemplate 的模板路徑等參數(shù)都可以通過(guò)view.config下發(fā)。引擎實(shí)現(xiàn)對(duì)照五種官方引擎均實(shí)現(xiàn)同一個(gè) EngineInterface接口簽名如下interface EngineInterface { public function render(string $template, array $data, array $config): string; }對(duì)應(yīng)實(shí)現(xiàn)及關(guān)鍵行為引擎類依賴包模板后綴關(guān)鍵行為BladeEngine.phphyperf/view-engine或duncan3dc/blade.blade.php使用BladeInstance綁定 view_path/cache_path 后渲染SmartyEngine.phpsmarty/smarty.tplsetTemplateDir/setCacheDir/setCompileDir 后 assign 數(shù)據(jù)并 fetchTwigEngine.phptwig/twig可配template_suffixFilesystemLoader Environment 緩存渲染PlatesEngine.phpleague/plates默認(rèn).php可配file_extension直接使用 PlatesEngine渲染ThinkEngine.phpsy-records/think-template.html由 Think 配置決定整個(gè) config 傳入think\Template接入其他模板引擎假設(shè)要接入一個(gè)虛擬的TemplateEngine模板引擎只需要在任意位置創(chuàng)建對(duì)應(yīng)的類并實(shí)現(xiàn)Hyperf\View\Engine\EngineInterface接口?php declare(strict_types1); namespace App\Engine; use Hyperf\View\Engine\EngineInterface; class TemplateEngine implements EngineInterface { public function render($template, $data, $config): string { // 實(shí)例化對(duì)應(yīng)的模板引擎 $engine new TemplateInstance(); // 調(diào)用對(duì)應(yīng)的渲染方法 return $engine-render($template, $data); } }然后修改 View 組件的配置把engine指向自定義引擎類?php use App\Engine\TemplateEngine; return [ // 將 engine 參數(shù)改為你的自定義模板引擎類 engine TemplateEngine::class, mode Mode::TASK, config [ view_path BASE_PATH./storage/view/, cache_path BASE_PATH./runtime/view/, ], ];使用以下以BladeEngine為例演示完整的使用流程。1. 創(chuàng)建視圖文件在view_path默認(rèn)storage/view/目錄下創(chuàng)建視圖文件index.blade.php!DOCTYPE html html langen head meta charsetUTF-8 titleHyperf/title /head body Hello, {{ $name }}. You are using blade template now. /body /html2. 在控制器中渲染在控制器中獲取Hyperf\View\Render實(shí)例實(shí)際注入的接口為Hyperf\View\RenderInterface調(diào)用render方法并傳入視圖文件地址index與渲染數(shù)據(jù)。文件地址不需要包含視圖文件的后綴?php declare(strict_types1); namespace App\Controller; use Hyperf\HttpServer\Annotation\AutoController; use Hyperf\View\RenderInterface; #[AutoController] class ViewController { public function index(RenderInterface $render) { return $render-render(index, [name Hyperf]); } }3. 訪問(wèn)結(jié)果訪問(wèn)對(duì)應(yīng)的 URL即可得到如下頁(yè)面內(nèi)容Hello, Hyperf. You are using blade template now.渲染接口與響應(yīng)細(xì)節(jié)RenderInterface.php 定義了三個(gè)方法render(string $template, array $data []): ResponseInterface返回完整 PSR-7 響應(yīng)對(duì)象直接作為控制器返回值即可getContents(string $template, array $data []): string僅返回渲染后的字符串適合嵌入到郵件、WebSocket 推送等非 HTTP 響應(yīng)場(chǎng)景getContentType(): string返回text/html內(nèi)容類型。Render.php 的render方法會(huì)把當(dāng)前上下文中的ResponseContext取出設(shè)置content-type響應(yīng)頭并把渲染字符串包裝為SwooleStream作為響應(yīng)體。content-type默認(rèn)是text/html如果配置了view.config.charset例如utf-8則會(huì)自動(dòng)拼接為text/html; charsetutf-8見(jiàn) Render.php。渲染過(guò)程中的任何異常都會(huì)被包裝為RenderException拋出。Blade 語(yǔ)法速覽如果使用官方推薦的hyperf/view-engine則可以獲得完整且與 Laravel 一致的 Blade 語(yǔ)法支持核心能力包括詳見(jiàn) view engine 文檔模板繼承通過(guò)extends、section、yield、parent組織布局與子頁(yè)面yield(content, default)支持默認(rèn)值數(shù)據(jù)輸出{{ $name }}會(huì)被htmlspecialchars自動(dòng)轉(zhuǎn)義以防 XSS{!! $name !!}輸出不轉(zhuǎn)義內(nèi)容json($array)便捷渲染 JSON流程控制if/elseif/else/endif、unless、isset/empty、switch/case/break、for/foreach/forelse/while以及$loop循環(huán)變量、continue/break條件簡(jiǎn)寫(xiě)組件與插槽類組件與匿名組件storage/view/components目錄、x-alert標(biāo)簽、$attributes屬性包、props、slot、x-dynamic-component動(dòng)態(tài)組件視圖命名空間通過(guò)view.namespaces配置為擴(kuò)展包提供package-name::view形式的模板引用并支持在storage/view/vendor/package-name下覆蓋擴(kuò)展包視圖。默認(rèn)引擎的占位行為當(dāng)engine保持NoneEngine::class即未安裝任何模板引擎時(shí)NoneEngine.php 會(huì)渲染一個(gè)包含 Bootstrap 樣式的提示頁(yè)面列出當(dāng)前可用的引擎及其安裝地址提示開(kāi)發(fā)者選擇下方引擎之一。這是組件開(kāi)箱即用但不綁定引擎設(shè)計(jì)意圖的體現(xiàn)。測(cè)試驗(yàn)證與異常處理組件自帶的單元測(cè)試 RenderTest.php 對(duì)核心行為做了完整驗(yàn)證testRender與testGetContents分別在Mode::TASK和Mode::SYNC兩種模式下渲染 tpl/index.tpl斷言響應(yīng)體內(nèi)容一致且content-type為text/html證明兩種模式產(chǎn)出等價(jià)testRenderException渲染不存在的模板index2.tpl斷言拋出RenderException且getPrevious()不為空說(shuō)明底層引擎異常會(huì)被正確包裝傳遞。異常體系方面組件定義了EngineNotFindException配置的引擎類在容器中不存在時(shí)拋出見(jiàn) Render.php與RenderException渲染過(guò)程中的任意異常統(tǒng)一包裝。實(shí)際開(kāi)發(fā)中若出現(xiàn)engine is not found類錯(cuò)誤請(qǐng)先確認(rèn)config/autoload/view.php中engine配置的類是否已安裝對(duì)應(yīng)依賴且類名正確。小結(jié)hyperf/view組件用一套極簡(jiǎn)的接口抽象統(tǒng)一了五種主流模板引擎的接入方式讓開(kāi)發(fā)者可以在不更換業(yè)務(wù)代碼的前提下自由切換模板技術(shù)棧。選型時(shí)把握三個(gè)關(guān)鍵點(diǎn)即可模板引擎決定模板語(yǔ)法與生態(tài)渲染模式?jīng)Q定進(jìn)程模型Task 模式安全但有跨進(jìn)程數(shù)據(jù)隔離約束Sync 模式高效但要求引擎協(xié)程安全目錄配置決定模板與緩存產(chǎn)物的落盤(pán)位置。如果需要完整原生的 Blade 體驗(yàn)優(yōu)先選擇hyperf/view-engine其基于 Laravel Blade 重寫(xiě)并推薦 SYNC 模式是官方文檔明確建議的搭配。贊分享后端微服務(wù)【免費(fèi)下載鏈接】hyperf A coroutine framework that focuses on hyperspeed and flexibility. Building microservice or middleware with ease.項(xiàng)目地址https://gitcode.com/gh_mirrors/hy/hyperf點(diǎn)擊查看免費(fèi)下載相關(guān)推薦oh-my-hermes路由預(yù)覽如何在運(yùn)行前看到請(qǐng)求將被派發(fā)到哪個(gè)模型oh my hermes路由預(yù)覽如何在運(yùn)行前看到請(qǐng)求將被派發(fā)到哪個(gè)模型 oh my hermes 是 Hermes Agent 的一體化插件內(nèi)置編碼智能、長(zhǎng)后端微服務(wù)Hyperf View 組件實(shí)戰(zhàn)指南接入 Blade / Smarty / Twig / Plates / ThinkTemplate 五大模板引擎掌握 Task 與 Sync 雙渲染模式Hyperf View 組件實(shí)戰(zhàn)指南接入 Blade / Smarty / Twig / Plates / ThinkTemplate 五大模板引擎掌握 T后端Web框架微服務(wù)RPC框架異步編程Hyperf View 視圖渲染組件完全指南五大模板引擎、Task/Sync 雙模式與自定義引擎擴(kuò)展Hyperf View 視圖渲染組件完全指南五大模板引擎、Task/Sync 雙模式與自定義引擎擴(kuò)展 本指南以 Hyperf 官方文檔中 View 組件的完整后端Web框架微服務(wù)RPC框架異步編程上一篇【親測(cè)免費(fèi)】 探索無(wú)界流暢翻閱——Google Translate for Mac下一篇firstmate任務(wù)形態(tài)實(shí)戰(zhàn)Ship交付任務(wù)與Scout調(diào)查任務(wù)如何選創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考