Introduction

Windwalker Renderer is a template engine adapters to easily render template files for different engines with same interface.

Support Engines

• PHP
• Twig
• Blade
• Edge (A Blade compitable engine without dependencies)
• Mustache
• Plates

Installation

Install via composer

composer require windwalker/renderer ^4.0

Use in Windwalker

By default, windwalker-starter will install renderer as dependency.

You can render a template by RendererService:

use Windwalker\Core\Renderer\RendererService;  $rendererService = $app->service(RendererService::class);  $rendererService->render('foo.bar'); // Will auto detect template file type

Use as Standalone Component

Getting Started

The basic PHP renderer is PlatesRenderer, which is an adapter of league/plates:

use Windwalker\Renderer\PlatesRenderer;  $renderer = new PlatesRenderer(  [  // Required  'base_dir' => '/path/to/tmpl'  ] );  // Make a template callback $template = $renderer->make('flower/sakura'); // Will load `/path/to/tmpl/flower/sakura.phtml`  // Render it echo $template(['foo' => 'bar']);  // You can render it again with different data echo $template(['foo' => 'goo']);

Directly render:

echo $renderer->render('flower/sakura', ['foo' => 'bar']);

Extends Template Engine

In Windwalker 4, Renderer on-longer keep the paths and leave engine to handle it.

Use extends to configure template engine before rendering:

$renderer->extend(  function (\League\Plates\Engine $engine) {  $engine->setDirectory('/another/tmpl/path');   return $engine;  } );

Custom Engine Builder

If you want to create your own engine, use setEngineBuilder():

$renderer->setEngineBuilder(  function () {  return new \League\Plates\Engine('/path/to/templates');  } );