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