Popular Twig Extensions

This document introduces popular third-party Twig extensions that can enhance your templates.

Installation

Install extensions via Composer, then register them in config/bootstrap.php (legacy layout: app/Config/bootstrap.php):

Configure::write('TwigView.extensions', [
    'ExtensionClassName',
]);

Twig Extensions

twig/intl-extra

Internationalization filters and functions using PHP's intl extension.

composer require twig/intl-extra

use Twig\Extra\Intl\IntlExtension;

Configure::write('TwigView.extensions', [
    new IntlExtension(),
]);

Features:

{# Format currency #}
{{ '1000.50'|format_currency('USD') }}  {# $1,000.50 #}

{# Format numbers #}
{{ '1234.56'|format_number }}  {# 1,234.56 #}

{# Format dates #}
{{ user.created|format_date('long') }}

{# Format datetime #}
{{ user.created|format_datetime('medium', 'short') }}

twig/string-extra

Additional string manipulation filters.

composer require twig/string-extra

use Twig\Extra\String\StringExtension;

Configure::write('TwigView.extensions', [
    new StringExtension(),
]);

Features:

{# Truncate string #}
{{ 'Lorem ipsum dolor'|u.truncate(10, '...') }}  {# Lorem ipsu... #}

{# Word wrap #}
{{ long_text|u.wordwrap(80) }}

{# Camelcase #}
{{ 'hello world'|u.camel }}  {# helloWorld #}

{# Snake case #}
{{ 'HelloWorld'|u.snake }}  {# hello_world #}

{# ASCII transliteration #}
{{ 'Tëst'|u.ascii }}  {# Test #}

twig/html-extra

HTML manipulation and generation.

composer require twig/html-extra

use Twig\Extra\Html\HtmlExtension;

Configure::write('TwigView.extensions', [
    new HtmlExtension(),
]);

Features:

{# Add CSS classes #}
<div class="{{ 'foo'|classes('bar', 'baz') }}">

{# Generate HTML attributes #}
<input {{ html_attributes({type: 'text', name: 'email'}) }}>

twig/markdown-extra

Markdown rendering in templates.

composer require twig/markdown-extra
composer require league/commonmark  # or michelf/php-markdown

use Twig\Extra\Markdown\MarkdownExtension;

Configure::write('TwigView.extensions', [
    new MarkdownExtension(),
]);

Features:

{# Render markdown #}
{{ '**bold** text'|markdown_to_html }}

{# Markdown block #}
{% apply markdown_to_html %}
# Heading
This is **markdown** content.
{% endapply %}

twig/cssinliner-extra

Inline CSS styles for email templates.

composer require twig/cssinliner-extra
composer require tijsverkoyen/css-to-inline-styles

use Twig\Extra\CssInliner\CssInlinerExtension;

Configure::write('TwigView.extensions', [
    new CssInlinerExtension(),
]);

Features:

{% apply inline_css %}
<html>
<head>
    <style>
        h1 { color: red; }
    </style>
</head>
<body>
    <h1>Hello</h1>
</body>
</html>
{% endapply %}

{# Output: <h1 style="color: red;">Hello</h1> #}

twig/inky-extra

Foundation for Emails framework integration.

composer require twig/inky-extra
composer require hampe/inky

use Twig\Extra\Inky\InkyExtension;

Configure::write('TwigView.extensions', [
    new InkyExtension(),
]);

Features:

{% apply inky_to_html %}
<row>
    <columns large="6"></columns>
    <columns large="6"></columns>
</row>
{% endapply %}

Third-Party Extensions

aptoma/twig-markdown

Another markdown extension with multiple parser support.

composer require aptoma/twig-markdown

jasny/twig-extensions

Collection of useful extensions including date, PCRE, text, and array filters.

NOTE

While this extension is used in cakephp/twig-view for CakePHP 5.x, it's recommended to use Twig's built-in features or official Twig Extra extensions when possible for better maintainability and compatibility.

composer require jasny/twig-extensions

Features:

• Date manipulation
• PCRE regex functions
• Text formatting
• Array operations

Creating Custom Extensions

See Configuration for how to create your own extensions.

Example structure:

use Twig\Extension\AbstractExtension;
use Twig\TwigFilter;
use Twig\TwigFunction;

class MyExtension extends AbstractExtension
{
    public function getFilters(): array
    {
        return [
            new TwigFilter('my_filter', [$this, 'myFilter']),
        ];
    }

    public function getFunctions(): array
    {
        return [
            new TwigFunction('my_function', [$this, 'myFunction']),
        ];
    }

    public function myFilter($value)
    {
        return strtoupper($value);
    }

    public function myFunction($arg)
    {
        return 'Result: ' . $arg;
    }
}

Resources

• Official Twig Extensions - Maintained by Twig team
• Twig Documentation - Complete Twig reference
• Creating Extensions - Official guide