README

更新：2022年6月27日

现在有一个官方的 Laravel Blade 分支

https://github.com/lukasleitsch/kirby-blade

Kirby Blade 使用 Laravel illuminate/view 9.x 包，并兼容 Kirby 3。

此包可以为您的 Kirby 应用程序启用 Laravel Blade。

Kirby 兼容性表

安装 Kirby 之前的重要提示

您应该从应用程序的根 index.php 中覆盖 Kirby 的 e() 辅助函数。因为 Laravel Blade 也有一个名为 e() 的辅助函数。

// override Kirby `e()` helper for Blade plugin
define('KIRBY_HELPER_E', false);

安装

使用 composer 安装

composer require afbora/kirby-blade

作为 git 子模块添加

git submodule add https://github.com/afbora/kirby-blade.git site/plugins/kirby-blade

手动

• 下载最新版本
• 解压下载的文件
• 将解压的文件夹复制/粘贴到您的 /site/plugins 文件夹

Blade 是什么？

根据 Laravel Blade 文档是

Blade 是 Laravel 提供的简单但强大的模板引擎。与其他流行的 PHP 模板引擎不同，Blade 不限制您在视图中使用纯 PHP 代码。事实上，所有 Blade 视图都被编译成纯 PHP 代码并缓存，直到它们被修改，这意味着 Blade 不会给您的应用程序增加任何开销。Blade 视图文件使用 .blade.php 文件扩展名。

用法

您可以使用 Blade 的强大功能，如 布局、表单、子视图、组件、指令以及您的自定义 if 语句。

有关 Laravel Blade 的所有文档都在 官方文档 中。

选项

该包的默认值是

所有值都可以在 config.php 文件中更新。

模板

默认模板文件夹是 site/templates 目录或您定义的 templates 目录，但您可以轻松更改它。

'afbora.blade.templates' => '/theme/default/templates',

视图

所有生成的视图都存储在 site/cache/views 目录或您定义的 cache 目录，但您可以轻松更改它。

'afbora.blade.views' => '/site/storage/views',

指令

默认情况下，Kirby Blade 包含以下指令

@asset($path)
@csrf()
@css($path)
@dump($variable)
@e($condition, $value, $alternative)
@get($key, $default)
@gist($url)
@go($url, $code)
@h($string, $keepTags)
@html($string, $keepTags)
@js($path)
@image($path, $attr) // @image('forrest.jpg', 'url')
@kirbytag($type, $value, $attr)
@kirbytags($text, $data)
@kirbytext($text, $data)
@kirbytextinline($text)
@kt($text)
@markdown($text)
@option($key, $default)
@page($key, $attr) // @page('blog', 'title')
@param($key, $fallback)
@site($attr) // @site(title')
@size($value)
@smartypants($text)
@snippet($name, $data)
@svg($file)
@t($key, $fallback)
@tc($key, $count)
@tt($key, $fallback, $replace, $locale)
@u($path, $options)
@url($path, $options)
@video($url, $options, $attr)
@vimeo($url, $options, $attr)
@widont($string)
@youtube($url, $options, $attr)

但您可以创建自己的

'afbora.blade.directives' => [
    'greeting' => function ($text)
    {
        return "<?php echo 'Hello: ' . $text ?>";
    },
],

Kirby 助手文档

https://getkirby.com/docs/reference/templates/helpers

如果语句

像指令一样，您可以创建自己的如果语句

'afbora.blade.ifs' => [
    'logged' => function ()
    {
        return !!kirby()->user();
    },
],

声明后，您可以使用它如下

@logged
    Welcome back {{ $kirby->user()->name() }}
@else
    Please Log In
@endlogged

压缩

设置

'afbora.blade.minify.enabled' => true,
'afbora.blade.minify.options' => [
    'doOptimizeViaHtmlDomParser' => true, // set true/false or remove line to default
    'doRemoveSpacesBetweenTags'  => false // set true/false or remove line to default
],

可用的压缩选项