README

A very thin module for using Twig with jdwx/web.

Installation

You can require it directly with Composer:

composer require jdwx/web-twig

Or download the source from GitHub: https://github.com/jdwx/web-twig.git

Requirements

This module requires PHP 8.3, Twig 3.0 or later, and jdwx/web 2.0 or later.

Usage

This module provides a simple interface for integrating Twig templates into the HtmlPage class provided by jdwx/web. The AbstractPage class can be subclassed to provide values when the template is rendered. The StaticPage class allows values to be provided when the page is instantiated. The MapPage class binds a Map that can be updated at any time.

Here is a basic usage example of using the StaticPage class:

$env = TwigHelper::forDirectory( __DIR__ . '/templates/' );
$page = new StaticPage( $env, 'static', [ 'name' => 'World' ] );
echo $page, "\n\n";

$map = new Map();
$page = new MapPage( $env, 'map', $map );
$map->put( 'name', 'Galaxy' );
echo $page, "\n\n";

You can also use subclasses to avoid repetitive code. For example, if you have all of your error page templates in one directory, you can create a subclass like this:

class ErrorPage extends StaticPage {


    /** @param array<string, mixed> $i_rValues */
    public function __construct( string $name, array $i_rValues = [] ) {
        # Give it the path to your error templates.
        $env = TwigHelper::forDirectory( __DIR__ . '/templates/' );
        parent::__construct( $env, $name, $i_rValues );
    }


    /** @param array<string, mixed> $i_rValues */
    public static function get( string $name, array $i_rValues = [] ) : string {
        return ( new self( $name, $i_rValues ) )->render();
    }


}

Then displaying errors is very straightforward:

echo ErrorPage::get( 'error404', [ 'return_url' => '/' ] ), "\n\n";

Stability

This module is relatively new and has not been extensively deployed in production yet, but the interface should be relatively stable. There's really not a lot to it; this module exists mainly to keep from introducing Twig as a dependency where it's not needed.

History

This module was loosely adapted from an existing codebase in early 2025.