Laravel框架中自定义模板指令总结

介绍

最近在学习laravel，在Laravel框架中使用模板的一种方法就是通过控制器布局，通常我们在视图模板中编写复杂的逻辑，看上去显得很杂乱，那么使用自定义的模板Directives，可以简化你的视图逻辑，编写出更优雅的代码，Laravel Blade是一种将其特殊语法编译成PHP和HTML的模板引擎。其特殊语法指令，指令是加糖功能，在其后隐藏杂乱的代码。模板包含大量的内置指令，例如@foreach/@if/@section/@extends等等，内置的指令对于做一个简单的项目足以，但是当你在代码中编写重复复杂的功能时，那么自定义模板指令或许可以帮你优化你的视图结构。

下面话不多说了，来一起看看详细的介绍吧。

自定义一个简单的模板指令

$expression参数是可选的

\Blade::directive('directive_name', function ($expression) {
 return $expression;
});

视图中用法Demo

<p>@hello('World')</p>

声明自定义模板指令的位置AppServiceProvider.php

<?php
namespace App\Providers;
use Illuminate\Support\Facades\Blade;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
 /**
  * Perform post-registration booting of services.
  *
  * @return void
  */
 public function boot()
 {
  Blade::directive('hello', function ($expression) {
   return "<?php echo 'Hello ' . {$expression}; ?>";
  });
 }
 /**
  * Register bindings in the container.
  *
  * @return void
  */
 public function register()
 {
  //
 }
}

以这种方式定义的指令加载成功，可以在任何模板中使用

注意事项

第一点

不能直接访问自定义指令中传递的多个参数，需要将其遍历出来

<p>@greet('Hi', 'Hammad')</p>
\Blade::directive('hello', function ($expression) {
 list($greet, $name) = explode(', ', $expression);

 return "<?php echo {$greet} . ' ' . {$name}; ?>";
});

像 array() list() 这种并不是一个函数，而是一种语言结构

第二点

一定要时刻记住需要过滤输出，一般使用{{}}时候，Blade已经预先执行了过滤操作，为了避免恶意用户将js代码注入到站点，一定要转义HTML，可以使用Laravel自带的函数e()，也相当于htmlentities()

\Blade::directive('hello', function ($expression) {
 return "<?php echo 'Hello ' . e({$expression}); ?>";
});

第三点

每次添加或修改自定义模板指令之后，一定要先清除缓存视图模板，可以使用clear Artisan

php artisan view:clear

Laravel5.5新特性

在使用自定义的模板指令的时候，大多数只是某种形式的条件，这些要求我们需要注册三个独立指令，if/else/endif,目前Laravel5.5已经支持简化条件指令，例如下面的实例，模板可以使用admin/else/endadmin

public function boot()
{
 \Blade::if('admin', function () {
  return auth()->check() && auth()->user()->isAdmin();
 });
}

总结