jblond/twig-trans

Twig 3 translation extension

v1.1.2 2024-11-18 12:15 UTC

Requires

• php: >=7.2
• ext-gettext: *
• ext-mbstring: *
• twig/twig: >=3.0.0

Requires (Dev)

• phpunit/phpunit: ^7 || ^8 || ^9 || ^10
• squizlabs/php_codesniffer: *

MIT

• Mario

• php
• i18n
• twig
• translation
• trans
• endtrans
• po file

README

Introduction

This is the replacement for the old Twig Extensions I18n / Intl / I18nExtension for the translation with po / mo gettext files.

I didn't want to install Symfony, but Twig only. Symfony seemed to be too much overhead.

This extension enables Twig templates to use |trans and {% trans %} + {% endtrans %} again

Install

composer require jblond/twig-trans

Example Use

<?php

use jblond\TwigTrans\Translation;
use Twig\Environment;
use Twig\Loader\FilesystemLoader;
use Twig\TwigFilter;

require '../vendor/autoload.php';

$langCode = 'de_DE';
putenv("LC_ALL=$langCode.UTF-8");
if (setlocale(LC_ALL, "$langCode.UTF-8") === false) {
    echo sprintf('Language Code %s not found', $langCode);
}

// set the path to the translation
bindtextdomain("Web_Content", "./locale");

// choose Domain
textdomain("Web_Content");

$twigConfig = [
    'cache' => false,
    'debug' => true,
    'auto_reload' => true
];

$twigLoader = new FilesystemLoader('./tpl/');
$twig = new Environment($twigLoader, $twigConfig);
// if you need  {{ dump() }} in the twig templates add
//$twig->addExtension(new DebugExtension());
// and use Twig\Extension\DebugExtension;  // at the top of the file

// this is for the filter |trans
$filter = new TwigFilter(
    'trans', 
    function ($context, $string) {
        return Translation::transGetText($string, $context);
    }, 
    ['needs_context' => true]
);
$twig->addFilter($filter);

// load the i18n extension for using the translation tag for twig
// {% trans %}my string{% endtrans %}
$twig->addExtension(new Translation());

try {
    $tpl = $twig->load('default.twig');
} catch (Exception $exception) {
    echo $exception->getMessage();
    die();
}

// the array parameter (context) is optional for the render function
echo $tpl->render(['key1' => 'value1', 'key2' => 'value2']);

Requirements

• PHP 7.2 or greater
• PHP Multibyte String ' gettext'
• Twig >= 3.0

Optional Requirements

• xgettext for Extract / generating po files.

License (MIT License)

see License

Tests

composer run-script php_src
composer run-script php_test
composer run-script phpunit

Contribution, wishes and bug

Raise an issue