Render files from the command line with Blade

 With the Laravel Blade CLI package, you can use the Blade engine to render files from the command line. This package doesn't support 100% of all Blade directives you might be familiar with in Laravel but does support common ones like @if, @else, @foreach, @forelse, @while, etc.

Give the following example file from the readme:

1name: {{ $name }}
2relationship: {{ $relationship }}
3favorite_food: {{ $favoriteFood }}
4@if($includeAddress)
5address: "123 example lane"
6@endif

You can render that file using the CLI:

1blade render ./person.yml \
2  --name="Bob" \
3  --relationship="Uncle" \
4  --favorite-food="Pizza" \
5  --include-address \
6  --save-directory="build/"

Which will save the file at ./build/person.yml

Installing this project globally via composer gives you access to the blade CLI command. However, you can also use the code directly from this package:

 1use BladeCLI\Blade;
 2use Illuminate\Container\Container;
 3use Illuminate\Filesystem\Filesystem;
 4 
 5$blade = new Blade(
 6    container: new Container,
 7    filesystem: new Filesystem,
 8    filePath: '/path/to/file/to/render',
 9    options: [
10        'force'=> true, // force overwrite existing rendered file
11        'save-directory'=>'save-to-dir' // optional directory to save rendered file to. Default is current directory.
12    ]
13);
14 
15// render the file with this data/vars
16$blade->render([
17    'var'=>'example'
18]);

You can also pass data to the template via JSON using the --from-json flag, which accepts a path to a JSON file. Finally, you can use this package to process an entire directory of templates:

1php blade render templates/ --some-data=foo --force

You can learn about this package, get full installation instructions, and view the source code on GitHub.

Read More

Manage navigational elements in Laravel apps

 Laravel Navigation is a package by Spatie to manage menus, breadcrumbs, and other navigational elements in Laravel apps.

While the Spatie Laravel Menu package is a Html menu generator for Laravel, think of this package as a "renderless component" for navigation components:

 1app(Navigation::class)
 2    ->add('Home', route('home'))
 3    ->add('Blog', route('blog.index'), function (Section $section) {
 4        $section
 5            ->add('All posts', route('blog.index'))
 6            ->add('Topics', route('blog.topics.index'));
 7    })
 8    ->addIf(Auth::user()->isAdmin(), function (Navigation $navigation) {
 9        $navigation->add('Admin', route('admin.index'));
10    });
11 
12// Render to tree
13app(Navigation::class)->tree();
14 
15/*
16 
17[
18    { "title": "Home", "url": "/", "active": false, "children": [] },
19    {
20        "title": "Blog",
21        "url": "/blog",
22        "active": false,
23        "children": [
24            { "title": "All posts", "url": "/blog", "active": false, "children": [] },
25            { "title": "Topics", "url": "/blog/topics", "active": true, "children": [] }
26        ],
27    },
28    { "title": "Admin", "url": "/admin", "active": false, "children": [] }
29]
30 
31*/

With this package you and also generate breadcrumbs from navigation using the following method:

 1// Append additional pages in your controller
 2app(Navigation::class)->activeSection()->add($topic->name, route('blog.topics.show', $topic));
 3 
 4// Render to breadcrumbs
 5app(Navigation::class)->breadcrumbs();
 6 
 7/*
 8[
 9    { "title": "Blog", "url": "/blog" },
10    { "title": "Topics", "url": "/blog/topics" },
11    { "title": "Laravel", "url": "/blog/topics/laravel" }
12]
13*/

You can learn about this package, get full installation instructions, and view the source code on GitHub. Thanks to Sebastian De Deyne and the Spatie team for this package, and all the fantastic open-source PHP and Laravel packages like this one 👏

Read More