protonemedia / laravel-blade-on-demand

Compile Blade templates in memory

Stars
3

Laravel Blade On Demand

Latest Version on Packagist
Build Status
Quality Score
Total Downloads

Laravel package to compile Blade templates in memory. Requires PHP 7.2 or higher, compatible with Laravel 6 and 7.

Installation

You can install the package via composer:

composer require protonemedia/laravel-blade-on-demand

Usage

Render Blade template

You can render any valid Blade Template by calling the render method on the BladeOnDemand facade. The method only takes two parameters, the template content and the data you want to pass to the template.

$output = BladeOnDemand::render('Hello {{ $name }}', ['name' => 'Protone Media']);

echo $output;

// "Hello Protone Media"

This is a just an example but you can use statements, components and other Blade features as well.

Handle missing variables

This feature prevents your render from failing whenever a variable is missing in your data array. By default it will fill the missing variable with the name of the variable itself. In this case $name is missing so the data array becomes ['name' => 'name'];

$output = BladeOnDemand::fillMissingVariables()->render('Hello {{ $name }}', []);

echo $output;

// "Hello name"

You could also use this feature to preview a template without any data. Note that this might give unexpected results when using statements. You can also pass a callable to the fillMissingVariables method to customize the handling of missing variables:

$output = BladeOnDemand::fillMissingVariables(
    fn ($variable) => "_MISSING_{$variable}_MISSING_"
)->render('Hello {{ $name }}');

echo $output;

// "Hello _MISSING_name_MISSING_"

Render Markdown Mail to HTML

This feature can be used to render a mail as if you're using a Markdown mailable.

$contents = implode(PHP_EOL, [
    '@component("mail::message")',
    '# Hello {{ $name }}',
    '@endcomponent',
]);

$output = BladeOnDemand::renderMarkdownMailToHtml($contents, ['name' => 'Protone Media']);

echo $output;

// <!DOCTYPE>
// <html xmlns="http://www.w3.org/1999/xhtml">
// <head>
//     ...
// </head>
// <body>
// <style>
//     ...
// </style>

// <table>
//     ...
//     <h1>Hello Protone Media</h1>
//     ...
// </table>
// </body>
// </html>

You can optionally specify a theme, just like calling the theme method on a Mailable.

BladeOnDemand::theme('invoice')->renderMarkdownMailToHtml($contents, $data);

Render Markdown Mail to text

Similair feature as the above renderMarkdownMailToHtml method except it uses components from the text directory. You can read more about this feature in the Laravel documentation.

$contents = implode(PHP_EOL, [
    '@component("mail::message")',
    '# Hello {{ $name }}',
    '@endcomponent',
]);

$output = BladeOnDemand::renderMarkdownMailToText($contents, ['name' => 'Protone Media']);

echo $output;

// [AppName](http://localhost)
//
// # Hello Protone Media
//
// © 2020 AppName. All rights reserved.

Parse Maildown Mail

The parseMarkdownMail method is the same as the renderMarkdownMailToText method but it also parses the Markdown.

$contents = implode(PHP_EOL, [
    '@component("mail::message")',
    '# Hello {{ $name }}',
    '@endcomponent',
]);

$output = BladeOnDemand::parseMarkdownMail($contents, ['name' => 'Protone Media']);

echo $output;

// <p><a href="http://localhost">AppName</a></p>
// <h1>Hello Protone Media</h1>
// <p>© 2020 AppName. All rights reserved.</p>

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.