README

Knife 是 Laravel 的 Blade 模板引擎的一个扩展，它支持一些在默认 blade 语法中未包含的便捷指令。

支持的指令

• @datetime、@date、@time - 分别显示日期时间、日期和时间字符串。指令接受所有可以被 Carbon 的 parse 方法解析的有效日期/对象。您可以使用 配置文件 为 Knife 定义要使用的日期时间格式。
• @use - 从不同的命名空间导入一个类，并在代码中使用它，而不必始终指定完整的类路径。
• @nl2br - 将文本中的换行符替换为 <br/> 标签。
• @escape - 通过转义引号和其他字符来显示文本。它基本上使用了 addslashes() 方法。在输出 JavaScript 字符串时非常有用。
• @breakpoint - 在指定位置添加一个 xdebug 断点。有助于调试生成的视图。
• @set - 定义一个新的变量。

这是库的第一个版本。很快将添加更多指令。

安装

注意：Knife 仅支持 Laravel 5.1 或更高版本。

1. 首先使用 composer 添加库

   composer require froiden/knife:~5.1

2. 将服务提供者添加到 app.php

   Froiden\Knife\KnifeServiceProvider::class

配置

您可以在 Knife 的配置文件中指定要使用的日期时间格式。要使用它，请按以下方式导出配置文件

php artisan vendor:publish

名为 knife.php 的配置文件将被创建在其他所有配置文件所在的配置文件夹中。

一些示例

@use('Carbon\Carbon') // Observe that we have used only Carbon below instead of \Carbon\Carbon

@datetime('now') // 28th August 2015, 11:27 am
@date('now') // 28th August 2015
@time('2015-08-28 09:37:38') // 09:37 am

@set($count, 1)
{{ $count++ }} // 1
{{ $count++ }} // 2

@set($new)
{{ $new }}
{{ Carbon::now() }} // 2015-08-28 09:37:38

$bio = <<<HERE
Froiden Knife Plugin
nl2br demo
HERE;

@nl2br($bio)
/*
Froiden Knife Plugin<br/>
nl2br demo
*/

@escape("You're writing an unescaped string") \\ You\'re writing an unescaped string

建议

我们欢迎建议。请将您的建议和反馈发送到 shashank@froiden.com 或在 GitHub 上创建问题。

许可证

MIT 许可证 (MIT)

版权所有 (c) 2015 - Froiden

在此特此免费授予任何人获取本软件及其相关文档文件（以下简称“软件”）的副本的权利，不受限制地处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件的副本，并允许向提供软件的个人做上述行为，前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何形式的保证，无论是明示的还是暗示的，包括但不限于适销性、特定用途的适用性和非侵权性保证。在任何情况下，作者或版权所有者不对任何索赔、损害或其他责任负责，无论这些责任是因合同、侵权或其他方式引起的，与软件或软件的使用或其它相关事宜有关。