abitofmaya/blade-renderer

独立Blade模板渲染器

v1.0.0 2024-08-24 13:48 UTC

This package is auto-updated.

Last update: 2024-09-24 14:22:17 UTC


README

Blade Renderer 是围绕 illuminate/view 的一个简单包装,后者是用于与 Blade 模板引擎一起使用的 Laravel 的包。

此包允许在无需安装完整 Laravel 框架的情况下,在任意 PHP 项目中使用 Blade 强大且表达性强的语法。它抽象化了渲染 Blade 模板所需的设置和配置,使其在非 Laravel 项目中使用更加方便和直接。

它使用与 Laravel 类似的目录结构来组织 viewscaches
视图存储在 resources/views 目录中,视图缓存存储在 storage/framework/views

使用方法

Blade Renderer 可以以下两种方式之一使用。

作为独立项目

您可以使用 Blade Renderer 快速开始一个新的独立项目。为此,请按照以下步骤操作

  1. 创建新项目

    在终端中运行以下命令以创建新项目。

    composer create-project abitofmaya/blade-renderer <project-name>
  2. 运行开发服务器

    导航到项目目录,并通过运行以下命令启动 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 作为项目依赖项包含。以下是方法

  1. 安装包

    在终端中运行以下命令以安装 Blade Renderer。

    composer require abitofmaya/blade-renderer
  2. 设置目录结构

    安装后,您需要手动设置视图和缓存的目录结构。创建以下目录

    • resources/views 用于存储您的 Blade 模板。
    • storage/framework/views 用于存储视图缓存。