Leaf + Blade
Blade is a templating engine included with Laravel that helps you create dynamic views easily. Unlike other templating engines, Blade allows you to use regular PHP code inside your templates together with all the goodness it offers you. Behind the scenes, Blade templates are turned into plain PHP and cached, so they run quickly without slowing down your app. Blade files use the .blade.php
extension to distinguish them from regular PHP files.
Leaf Blade is a port of the jenssegers/blade package that allows you to use blade templates in your Leaf PHP projects.
New to Blade?
This video by The Net Ninja will help you get started with blade.
Setting Up
Blade + Leaf MVC
Blade comes with Leaf MVC out of the box, fully configured and ready to use. However, if you're using Leaf Core, you'll need to set up Blade yourself.
You can install Leaf Blade using the Leaf CLI:
leaf install blade
composer require leafs/blade
After this, you just need to inform Leaf of Blade's existence:
app()->attachView(Leaf\Blade::class);
This will magically set up Blade for you and pop up a blade()
function you can use to render your Blade views.
app()->blade()->configure([
'views' => 'views',
'cache' => 'storage/cache'
]);
Magic! You can now use Blade to create and render your views.
Creating Blade Views
Blade views are a pretty sweet mixture of HTML, PHP, and clean syntax. You can create a new Blade view by creating a new file with the .blade.php
extension in your "views" folder. Here's an example of a simple Blade view:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
</head>
<body>
<h1>Hello, {{ $name }}</h1>
</body>
</html>
This should look pretty familiar if you know HTML (of course you do). The only difference is the part. This is Blade's way of creating a variable in your view. When you render this view, Blade will allow you pass in a variable called
$name
and it will be displayed in place of . Let's see how you can render this view.
Rendering Blade Views
Remember we set up Blade earlier? Now we can use it to render our Blade views. Here's how you can render the hello.blade.php
view we created earlier:
echo app()->blade()->render('hello', ['name' => 'Michael']);
This will render the hello.blade.php
view and pass in a variable called name
with the value Michael
. When you open the view in your browser, you should see a big "Hello, Michael" on your screen.
Extending Blade Views
Blade allows you to define custom directives using the directive()
method. When the Blade compiler encounters the custom directive, it will call the provided callback with the expression that the directive contains. The callback is free to return the value of its contents however you like:
app()->blade()->directive('datetime', function ($expression) {
return "<?php echo with({$expression})->format('F d, Y g:i a'); ?>";
});
Which allows you to use the following in your blade template:
Current date: @datetime($date)
This will output the current date in the format F d, Y g:i a
. You can define as many custom directives as you want to make your Blade views more powerful.
Conclusion
This is just the beginning of what you can do with Blade. Blade is a powerful templating engine that allows you to create dynamic views with ease. You can use Blade to create complex views with loops, conditions, and even include other views. As this is just an adapter for the original Blade package, you can check out the Blade documentation for more information on what you can do with Blade.