abitofmaya / blade-renderer
独立Blade模板渲染器
v1.0.0
2024-08-24 13:48 UTC
Requires
- php: ^8.2
- illuminate/view: ^11.20
README
Blade Renderer
是围绕 illuminate/view
的一个简单包装,后者是用于与 Blade
模板引擎一起使用的 Laravel
的包。
此包允许在无需安装完整 Laravel 框架的情况下,在任意 PHP 项目中使用 Blade 强大且表达性强的语法。它抽象化了渲染 Blade 模板所需的设置和配置,使其在非 Laravel 项目中使用更加方便和直接。
它使用与 Laravel 类似的目录结构来组织 views
和 caches
。
视图存储在 resources/views
目录中,视图缓存存储在 storage/framework/views
。
使用方法
Blade Renderer
可以以下两种方式之一使用。
作为独立项目
您可以使用 Blade Renderer 快速开始一个新的独立项目。为此,请按照以下步骤操作
-
创建新项目
在终端中运行以下命令以创建新项目。
composer create-project abitofmaya/blade-renderer <project-name>
-
运行开发服务器
导航到项目目录,并通过运行以下命令启动 PHP 开发服务器
php -S localhost:8000 -t public
示例
-
使用以下内容编辑
src/app.php
<?php use abitofmaya\BladeRenderer\BladeRenderer; $renderer = new BladeRenderer(); $posts = [ [ 'title' => 'The Art of Minimalism: Living with Less', 'description' => 'Learn how to declutter your life and find happiness in simplicity.' ], [ 'title' => 'The Future of Technology', 'description' => 'Dive into the technological advancements shaping the future.' ] ]; echo $renderer->view(view: 'bladeRenderer', data: ['posts' => $posts]);
-
在
resources/views
目录中创建bladeRenderer.blade.php
,内容如下。<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Blade Renderer</title> </head> <body> @foreach($posts as $post) <div> <p><strong>Title</strong>: {{ $post['title'] }}</p> <p><strong>Description</strong>: {{ $post['description'] }}</p> </div> @endforeach </body> </html>
作为现有项目的依赖项
如果您有一个现有的 PHP 项目并且想添加 Blade 模板功能,可以将 Blade Renderer 作为项目依赖项包含。以下是方法
-
安装包
在终端中运行以下命令以安装 Blade Renderer。
composer require abitofmaya/blade-renderer
-
设置目录结构
安装后,您需要手动设置视图和缓存的目录结构。创建以下目录
resources/views
用于存储您的 Blade 模板。storage/framework/views
用于存储视图缓存。