README

这是 Shopify Liquid 模板引擎的 Laravel 视图集成。它使用 keepsuit/liquid PHP 版本来解析 liquid 模板。

安装

您可以通过 composer 安装此包

composer require keepsuit/laravel-liquid

用法

1. 在 resources/views 文件夹中创建一个 liquid 模板文件（例如 home.liquid）。
2. 使用 Laravel 视图引擎按常规渲染模板。

class HomeController extends Controller
{
    public function index()
    {
        return view('home');
    }
}

标签

除了标准 Liquid 标签外，此包还提供了一些自定义标签。

Auth

检查用户是否已认证。与 laravel @auth 指令相同。

{% auth %}
user is authenticated
{% endauth %}

{% guest %}
user is not authenticated
{% endguest %}

或使用自定义守卫

{% auth('admin') %}
admin is authenticated
{% endauth %}

{% guest 'admin' %}
admin is not authenticated
{% endguest %}

Env

检查应用程序环境是否为指定的环境。与 laravel @env 指令相同。

{% env 'production' %}
application is in production environment
{% endenv %}

Session

检查会话是否具有特定的键。与 laravel @session 指令相同。可以使用 value 变量访问会话键的值。

{% session 'status' %}
<div class="p-4 bg-green-100">
  {{ value }}
</div>
{% endsession %}

Error

检查给定字段是否存在验证错误。与 laravel @error 指令相同。可以使用 message 变量访问错误信息。

{% error 'email' %}
<div class="text-red-500 text-sm">
  {{ message }}
</div>
{% enderror %}

Csrf field

生成一个隐藏的 CSRF 令牌表单字段。与 laravel @csrf 指令相同。

<form method="POST" action="/foo">
  {% csrf %}
  ...
</form>

Vite

将您的 vite 资产添加到模板中。与 laravel @vite 指令相同。

{% vite 'resources/css/app.css', 'resources/js/app.js' %}

{% comment %}With custom build directory{% endcomment %}
{% vite "resources/js/app.js", directory: "custom" %}

过滤器

除了标准 Liquid 过滤器外，此包还提供了一些自定义过滤器。

Debug

使用 dump 和 dd 过滤器调试变量内容。

{{ variable | dump }}

{{ variable | dd }}

Localization

使用 Laravel 本地化系统使用 trans（或 t 别名）和 trans_choice 过滤器翻译字符串。

{{ 'messages.welcome' | trans }}

{{ 'messages.items_count' | trans_choice: 3 }}

Url

使用 Laravel URL 助手生成 URL。

{{ 'app.js' | asset }}
{{ 'app.js' | secure_asset }}

{{ '/home' | url }}
{{ '/home' | secure_url }}

{{ 'home' | route }}

测试

composer test

更新日志

有关最近更改的更多信息，请参阅 更新日志。

鸣谢

• Fabio Capucci
• 所有贡献者

许可证

MIT 许可证（MIT）。有关更多信息，请参阅 许可证文件。