包简介

Compile Blade templates in memory

README 文档

README

Laravel package to compile Blade templates in memory. Requires PHP 8.2 or higher, compatible with Laravel 11+.

Sponsor Us

❤️ We proudly support the community by developing Laravel packages and giving them away for free. If this package saves you time or if you're relying on it professionally, please consider sponsoring the maintenance and development and check out our latest premium package: Inertia Table. Keeping track of issues and pull requests takes time, but we're happy to help!

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.

Other Laravel packages

Inertia Modal: With Inertia Modal, you can easily open any route in a Modal or Slideover without having to change anything about your existing routes or controllers.

Inertia Table: The Ultimate Table for Inertia.js with built-in Query Builder.
Laravel Cross Eloquent Search: Laravel package to search through multiple Eloquent models.
Laravel Eloquent Scope as Select: Stop duplicating your Eloquent query scopes and constraints in PHP. This package lets you re-use your query scopes and constraints by adding them as a subquery.
Laravel FFMpeg: This package provides an integration with FFmpeg for Laravel. The storage of the files is handled by Laravel's Filesystem.
Laravel MinIO Testing Tools: Run your tests against a MinIO S3 server.
Laravel Mixins: A collection of Laravel goodies.
Laravel Paddle: Paddle.com API integration for Laravel with support for webhooks/events.
Laravel Task Runner: Write Shell scripts like Blade Components and run them locally or on a remote server.
Laravel Verify New Email: This package adds support for verifying new email addresses: when a user updates its email address, it won't replace the old one until the new one is verified.
Laravel XSS Protection: Laravel Middleware to protect your app against Cross-site scripting (XSS). It sanitizes request input, and it can sanatize Blade echo statements.

Security

If you discover any security related issues, please email pascal@protone.media instead of using the issue tracker.

Credits

License

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

protonemedia/laravel-blade-on-demand 适用场景与选型建议

protonemedia/laravel-blade-on-demand 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 46.39k 次下载、GitHub Stars 达 62，最近一次更新时间为 2020 年 02 月 12 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「protonemedia」「laravel-blade-on-demand」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 protonemedia/laravel-blade-on-demand 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 protonemedia/laravel-blade-on-demand 我们能提供哪些服务？

定制开发 / 二次开发

基于 protonemedia/laravel-blade-on-demand 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 protonemedia/laravel-blade-on-demand 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

protonemedia/laravel-task-runner 133

Write Shell scripts like Blade Components and run them locally or on a remote server

protonemedia/laravel-tracer 2

protonemedia/laravel-minio-testing-tools 15

This is my package laravel-minio-testing-tools

protonemedia/laravel-splade-core 46

A package to use Vue 3's Composition API in Laravel Blade.

unifysofttech-pbmedia/laravel-ffmpeg 1

FFMpeg for Laravel

tomatophp/splade 0

Splade Core For FilamentPHP with a lot of custom components.

protonemedia/laravel-blade-on-demand

包简介

关键字：