### Install IntlExtension with Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_date.rst

Install the IntlExtension using Composer to enable date and time formatting filters.

```bash
composer require twig/intl-extra
```

--------------------------------

### Installing the String Extension via Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/plural.rst

Shows the composer command to install the StringExtension, which is required for the plural filter.

```bash
$ composer require twig/string-extra
```

--------------------------------

### Install MarkdownExtension via Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/html_to_markdown.rst

Install the MarkdownExtension using Composer, which is required for the html_to_markdown filter.

```bash
$ composer require twig/markdown-extra
```

--------------------------------

### Install IntlExtension via Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/currency_symbol.rst

Instructions for installing the Twig IntlExtension using Composer, which is required for the currency_symbol filter.

```bash
$ composer require twig/intl-extra
```

--------------------------------

### Install Inky Extension with Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/inky_to_html.rst

Install the InkyExtension using Composer. This is required to use the inky_to_html filter.

```bash
$ composer require twig/inky-extra
```

--------------------------------

### Installing HtmlExtension

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/html_attr_type.rst

Provides instructions for installing the HtmlExtension, which is required for the html_attr_type filter. Includes Composer commands and explicit extension addition for Twig environments.

```bash
$ composer require twig/html-extra
```

```bash
$ composer require twig/extra-bundle
```

```php
use Twig\Extra\Html\HtmlExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new HtmlExtension());
```

--------------------------------

### Install HtmlExtension via Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/data_uri.rst

Install the necessary HtmlExtension for the data_uri filter using Composer. This is a prerequisite for using the filter.

```bash
$ composer require twig/html-extra
```

--------------------------------

### Install CacheExtension via Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/cache.rst

Install the CacheExtension using Composer. This extension is required for the cache tag functionality.

```bash
$ composer require twig/cache-extra
```

--------------------------------

### Install Twig Extra Bundle in Symfony

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/currency_symbol.rst

Instructions for installing the twig/extra-bundle in Symfony projects, which includes the IntlExtension.

```bash
$ composer require twig/extra-bundle
```

--------------------------------

### Environment Setup and Template Loading

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Demonstrates how to create a Twig environment and load a template using the FilesystemLoader.

```APIDOC
## Environment Setup and Template Loading

### Description
This section shows the typical way to configure Twig by creating an environment object and setting up a loader to find templates.

### Method
Constructor and method calls

### Endpoint
N/A (PHP API)

### Parameters
#### Environment Constructor
- **loader** (*object*) - Required - An instance of a Twig Loader (e.g., \Twig\Loader\FilesystemLoader).
- **options** (*array*) - Optional - An array of configuration options for the environment.

#### Options Array
- **cache** (*string* or *false*) - Optional - An absolute path for compiled templates, or false to disable.

### Request Example
```php
require_once '/path/to/vendor/autoload.php';

$loader = new \Twig\Loader\FilesystemLoader('/path/to/templates');
$twig = new \Twig\Environment($loader, [
    'cache' => '/path/to/compilation_cache',
]);

$template = $twig->load('index.html.twig');
```

### Response
#### Success Response
- **twig** (*object*) - An instance of \Twig\Environment.
- **template** (*object*) - An instance of \Twig\TemplateWrapper.
```

--------------------------------

### Install Twig with Composer

Source: https://github.com/twigphp/twig/blob/3.x/doc/installation.rst

Use this command to add Twig to your project dependencies via Composer. Ensure Composer is installed and in your PATH.

```bash
composer require "twig/twig:^3.0"
```

--------------------------------

### Twig Profiler Extension Setup

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Initializes and uses the Twig Profiler extension to gather performance metrics for template executions.

```php
$profile = new \Twig\Profiler\Profile();
    $twig->addExtension(new \Twig\Extension\ProfilerExtension($profile));

    $dumper = new \Twig\Profiler\Dumper\TextDumper();
    echo $dumper->dump($profile);
```

--------------------------------

### Basic Usage of format_datetime

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_datetime.rst

Formats a date-time string using the default settings. Ensure the IntlExtension is installed.

```twig
{{ '2019-08-07 23:39:12'|format_datetime() }}
```

--------------------------------

### Install CssInlinerExtension

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/inline_css.rst

The inline_css filter requires the CssInlinerExtension. Install it using Composer. For Symfony projects, also install the extra-bundle.

```bash
$ composer require twig/cssinliner-extra
```

```bash
$ composer require twig/extra-bundle
```

--------------------------------

### Twig Inline Comment Example

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Demonstrates the use of inline comments in Twig templates. Comments start with # and extend to the end of the line.

```twig
{{ "Hello World"|upper # this is an inline comment }}
```

--------------------------------

### Operator Precedence Example

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Shows how Twig converts expressions to PHP based on operator precedence. It demonstrates the default conversion and how to alter precedence using parentheses.

```twig
{{ 6 b-and 2 or 6 b-and 16 }}

{# it is converted to the following PHP code: (6 & 2) || (6 & 16) #}

{% set greeting = 'Hello ' %}
{% set name = 'Fabien' %}

{{ greeting ~ name|lower }}   {# Hello fabien #}

{# use parenthesis to change precedence #}
{{ (greeting ~ name)|lower }} {# hello fabien #}
```

--------------------------------

### Arrow Function Examples

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Illustrates the use of arrow functions (=>) for creating concise anonymous functions. Examples show their use with filters and how to store them in variables.

```twig
{{ people|map(p => p.first_name)|join(', ') }}

{% set first_name_fn = (p) => p.first_name %}

{{ people|map(first_name_fn)|join(', ') }}
```

--------------------------------

### Spread Operator Examples

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Shows how to use the spread operator (...) to expand sequences or mappings when creating new ones, and to expand arguments for function calls.

```twig
{% set numbers = [1, 2, ...moreNumbers] %}
{% set ratings = {'q1': 10, 'q2': 5, ...moreRatings} %}

{{ 'Hello %s %s!'|format(...['Fabien', 'Potencier']) }}
```

--------------------------------

### Slicing a string omitting start argument

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/slice.rst

Shows how to slice a string from the beginning by omitting the start argument in the [] operator.

```twig
{{ '12345'[:2] }} {# will display "12" #}
```

--------------------------------

### Twig: Math Operations

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Provides examples of basic arithmetic operations supported in Twig templates.

```twig
{{ 1 + 1 }}
```

```twig
{{ 3 - 2 }}
```

```twig
{{ 1 / 2 }}
```

```twig
{{ 11 % 7 }}
```

```twig
{{ 20 // 7 }}
```

```twig
{{ -20 // 7 }}
```

```twig
{{ 2 * 2 }}
```

```twig
{{ 2 ** 3 }}
```

```twig
{{ -1**0 }}
```

--------------------------------

### Add IntlExtension Explicitly to Twig Environment

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/currency_symbol.rst

Example of how to manually add the IntlExtension to the Twig environment if not using the extra bundle.

```php
use Twig\Extra\Intl\IntlExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new IntlExtension());
```

--------------------------------

### Registering Runtime Extensions with Attributes

Source: https://github.com/twigphp/twig/blob/3.x/doc/advanced.rst

If extension methods are not static, register the class as a runtime extension using a runtime loader. This example shows how to register a class with a constructor dependency.

```php
use Twig\Attribute\AsTwigFunction;

class ProjectExtension
{
    // Inject hypothetical dependencies
    public function __construct(private LipsumProvider $lipsumProvider) {}

    #[AsTwigFunction('lipsum')]
    public function lipsum(int $count): string
    {
        return $this->lipsumProvider->lipsum($count);
    }
}

$twig = new \Twig\Environment($loader);
$twig->addExtension(new \Twig\Extension\AttributeExtension(ProjectExtension::class);
$twig->addRuntimeLoader(new \Twig\RuntimeLoader\FactoryLoader([
    ProjectExtension::class => function () use ($lipsumProvider) {
        return new ProjectExtension($lipsumProvider);
    },
]));
```

--------------------------------

### Twig String Starts With Operator

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Checks if a string begins with a specified substring.

```twig
{% if 'Fabien' starts with 'F' %}
{% endif %}
```

--------------------------------

### Basic Range

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/range.rst

Generates a sequence of integers from a start to an end value.

```twig
{% for i in range(0, 3) %}
    {{ i }},
{% endfor %}

{# outputs 0, 1, 2, 3, #}
```

--------------------------------

### Twig Reduce Filter with Initial Value

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/reduce.rst

Shows how to use the reduce filter with an initial value. The second argument to the filter sets the starting point for the accumulation.

```twig
{{ numbers|reduce((carry, value, key) => carry + value * key, 10) }}
{# output 18 #}
```

--------------------------------

### Get Locale Name in Specified Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/locale_name.rst

Returns the locale name translated into a specified locale. Ensure the IntlExtension is installed.

```twig
{# allemand #}
{{ 'de'|locale_name('fr') }}
```

```twig
{# français (Canada) #}
{{ 'fr_CA'|locale_name('fr_FR') }}
```

--------------------------------

### Get Template Content

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/source.rst

Use the 'source' function to retrieve the raw content of a template file. Pass the template name as an argument.

```twig
{{ source('template.html.twig') }}
{{ source(some_var) }}
```

--------------------------------

### Twig Extension Functional Test Setup

Source: https://github.com/twigphp/twig/blob/3.x/doc/advanced.rst

Sets up a functional test for a Twig extension using the IntegrationTestCase. This involves defining the extensions and specifying the directory for fixture files.

```php
namespace Project\Tests;

use Twig\Test\IntegrationTestCase;

class IntegrationTest extends IntegrationTestCase
{
    public function getExtensions()
    {
        return [
            new CustomTwigExtension1(),
            new CustomTwigExtension2(),
        ];
    }

    public function getFixturesDir()
    {
        return __DIR__.'/Fixtures/';
    }
}
```

--------------------------------

### Get Locale Name in Default Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/locale_name.rst

Returns the locale name using the current locale. Ensure the IntlExtension is installed.

```twig
{# German #}
{{ 'de'|locale_name }}
```

--------------------------------

### Using expressions for slice arguments

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/slice.rst

Illustrates using variables or expressions for the start and length arguments of the slice filter.

```twig
{% for i in [1, 2, 3, 4, 5]|slice(start, length) %}
    {# ... #}
{% endfor %}
```

--------------------------------

### Registering a Twig Extension

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Register a custom or built-in Twig extension using the addExtension() method. The SandboxExtension is shown as an example.

```php
$twig->addExtension(new \Twig\Extension\SandboxExtension());
```

--------------------------------

### Get Currency Names with Specific Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/currency_names.rst

This snippet shows how to retrieve currency names for a specific locale, in this case, French ('fr'). The results are formatted similarly to the default locale example.

```twig
{# afghani (1927–2002), afghani afghan, ... #}
{{ currency_names('fr')|join(', ') }}
```

--------------------------------

### FilesystemLoader with a single directory

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Initialize the FilesystemLoader to load templates from a specified directory.

```php
$loader = new \Twig\Loader\FilesystemLoader($templateDir);
```

--------------------------------

### Ternary Operator Examples

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Demonstrates the usage of the ternary operator for conditional expressions. It shows the standard form, a shorthand for when the condition and the true value are the same, and a shorthand for when the false value is an empty string.

```twig
{{ result ? 'yes' : 'no' }}
{{ result ?: 'no' }} is the same as {{ result ? result : 'no' }}
{{ result ? 'yes' }} is the same as {{ result ? 'yes' : '' }}
```

--------------------------------

### Rendering Templates

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Illustrates how to render a loaded template with variables, both directly and via the environment.

```APIDOC
## Rendering Templates

### Description
This section covers rendering templates with variables, either from a loaded template object or directly through the Twig environment.

### Method
- `render(array $context = [])` on \Twig\TemplateWrapper
- `render(string $name, array $context = [])` on \Twig\Environment
- `renderBlock(string $name, array $context = [])` on \Twig\TemplateWrapper

### Endpoint
N/A (PHP API)

### Parameters
#### TemplateWrapper::render()
- **context** (*array*) - Required - An associative array of variables to pass to the template.

#### Environment::render()
- **name** (*string*) - Required - The name of the template to load and render.
- **context** (*array*) - Required - An associative array of variables to pass to the template.

#### TemplateWrapper::renderBlock()
- **name** (*string*) - Required - The name of the block to render.
- **context** (*array*) - Required - An associative array of variables to pass to the template.

### Request Example
```php
// Rendering a loaded template
echo $template->render(['the' => 'variables', 'go' => 'here']);

// Rendering directly via environment
echo $twig->render('index.html.twig', ['the' => 'variables', 'go' => 'here']);

// Rendering a specific block
echo $template->renderBlock('block_name', ['the' => 'variables', 'go' => 'here']);
```

### Response
#### Success Response
- **Output** (*string*) - The rendered HTML content of the template or block.
```

--------------------------------

### Configure Twig Environment

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Sets up a Twig environment with a filesystem loader and a compilation cache directory. Ensure the autoloader is included.

```php
require_once '/path/to/vendor/autoload.php';

$loader = new 
\Twig\Loader\FilesystemLoader('/path/to/templates');
$twig = new 
\Twig\Environment($loader, [
    'cache' => '/path/to/compilation_cache',
]);
```

--------------------------------

### Assignment Operator Examples

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Demonstrates the assignment operator (=) for assigning values to variables within expressions. It covers simple assignments, chained assignments, and assignments within other expressions.

```twig
{# assign #}
{% do b = 1 + 3 %}

{# assign and output the result #}
{{ b = 1 + 3 }}

{# assignments can be chained #}
{% do a = b = 'foo' %}

{# assignment can be used inside other expressions #}
{% do a = (b = 4) + 5 %}
```

--------------------------------

### Destructuring Assignment Example

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Demonstrates destructuring assignment using the '=' operator to extract values from sequences and assign them to variables in a single operation.

```twig
{# returns the full user object, allowing chained access #}
```

--------------------------------

### FilesystemLoader addPath and prependPath

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Dynamically add or prepend template directories to the FilesystemLoader.

```php
$loader->addPath($templateDir3);
$loader->prependPath($templateDir4);
```

--------------------------------

### Get all language names

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/language_names.rst

This snippet shows how to get a comma-separated string of all available language names using the default locale.

```twig
{# Abkhazian, Achinese, ... #}
{{ language_names()|join(', ') }}
```

--------------------------------

### Include with 'only' Keyword

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/include.rst

Includes 'template.html.twig' while restricting variable access. The first example only allows 'name', and the second allows no variables from the parent context.

```twig
{# only the name variable will be accessible #}
{% include 'template.html.twig' with {'name': 'Fabien'} only %}

{# no variables will be accessible #}
{% include 'template.html.twig' only %}
```

--------------------------------

### Using a global object method for lipsum generation

Source: https://github.com/twigphp/twig/blob/3.x/doc/advanced.rst

Demonstrates calling a method on a global object ('text') to generate lorem ipsum text.

```twig
{{ text.lipsum(40) }}
```

--------------------------------

### Get First Element of an Array

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/first.rst

Use the 'first' filter to get the first item from an array. This works for numerical or associative arrays.

```twig
{{ [1, 2, 3, 4]|first }}
{# outputs 1 #}
```

--------------------------------

### Creating a Basic Twig Filter

Source: https://github.com/twigphp/twig/blob/3.x/doc/advanced.rst

Demonstrates the instantiation of a TwigFilter object with a name, a callable, and an options array.

```php
$filter = new \Twig\TwigFilter('rot13', 'str_rot13', $options);
```

--------------------------------

### Get Timezone Name (Specific Locale)

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/timezone_name.rst

Pass an explicit locale code to the timezone_name filter to get the timezone name in a specific language.

```twig
{# heure du Pacifique nord-américain (Los Angeles) #}
{{ 'America/Los_Angeles'|timezone_name('fr') }}
```

--------------------------------

### FilesystemLoader with multiple directories

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Configure the FilesystemLoader to search for templates across multiple directories, with a fallback mechanism.

```php
$loader = new \Twig\Loader\FilesystemLoader([$templateDir1, $templateDir2]);
```

--------------------------------

### Get Currency Symbol for EUR and JPY

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/currency_symbol.rst

Demonstrates how to use the currency_symbol filter to get the symbols for EUR and JPY using the default locale.

```twig
{# € #}
{{ 'EUR'|currency_symbol }}

{# ¥ #}
{{ 'JPY'|currency_symbol }}
```

--------------------------------

### FilesystemLoader with relative paths and getcwd

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Initialize FilesystemLoader using relative paths and getcwd for cache key independence. Twig defaults to getcwd() for relative paths if the root path is not provided.

```php
$loader = new \Twig\Loader\FilesystemLoader('templates', getcwd().'/..');
```

--------------------------------

### Get Currency Symbol for JPY with Specific Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/currency_symbol.rst

Shows how to use the currency_symbol filter with an explicit locale ('fr') to get the currency symbol for JPY.

```twig
{# ¥ #}
{{ 'JPY'|currency_symbol('fr') }}
```

--------------------------------

### Implementing __get and __isset for Dynamic Properties

Source: https://github.com/twigphp/twig/blob/3.x/doc/recipes.rst

Shows how to implement the magic __get and __isset methods in a PHP class to allow Twig to access dynamically generated properties.

```php
class Article
{
    public function __get($name)
    {
        if ('title' == $name) {
            return 'The title';
        }

        // throw some kind of error
    }

    public function __isset($name)
    {
        if ('title' == $name) {
            return true;
        }

        return false;
    }
}
```

--------------------------------

### Registering Undefined Function Callback

Source: https://github.com/twigphp/twig/blob/3.x/doc/recipes.rst

Shows how to register a callback to dynamically define Twig functions that are not explicitly registered. This example demonstrates auto-registering native PHP functions, but should be used with caution due to security implications.

```php
$twig->registerUndefinedFunctionCallback(function ($name) {
    if (function_exists($name)) {
        return new \Twig\TwigFunction($name, $name);
    }

    return false;
});
```

--------------------------------

### Get script names for the current locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/script_names.rst

Call script_names() without arguments to get script names for the default locale. The output is then joined into a comma-separated string.

```twig
{# Adlam, Afaka, ... #}
{{ script_names()|join(', ') }}
```

--------------------------------

### Load Template from String

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/template_from_string.rst

Demonstrates loading a simple template from a string using template_from_string.

```twig
{{ include(template_from_string("Hello {{ name }}")) }}
{{ include(template_from_string(page.template)) }}
```

--------------------------------

### Basic Cycle Usage

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/cycle.rst

Demonstrates the basic usage of the cycle function to alternate between 'odd' and 'even' strings based on the loop index.

```twig
{% set start_year = date() | date('Y') %}
{% set end_year = start_year + 5 %}

{% for year in start_year..end_year %}
    {{ cycle(['odd', 'even'], loop.index0) }}
{% endfor %}

```

--------------------------------

### Get Currency Names with Default Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/currency_names.rst

This snippet demonstrates how to get all currency names using the default locale. The output is joined by a comma and space for readability.

```twig
{# Afghan Afghani, Afghan Afghani (1927–2002), ... #}
{{ currency_names()|join(', ') }}
```

--------------------------------

### Get Timezone Name (Default Locale)

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/timezone_name.rst

Use the timezone_name filter to get the timezone name for a given ISO 8601 identifier using the current locale.

```twig
{# Central European Time (Paris) #}
{{ 'Europe/Paris'|timezone_name }}

{# Pacific Time (Los Angeles) #}
{{ 'America/Los_Angeles'|timezone_name }}
```

--------------------------------

### Include Function vs. Include Statement

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/include.rst

Demonstrates storing rendered template content in a variable using both the 'include' function and statement.

```twig
{# Store a rendered template in a variable #}
{% set content %} 
    {% include 'template.html.twig' %} 
{% endset %}
{# vs #}
{% set content = include('template.html.twig') %}
```

--------------------------------

### Get Current Date for Comparison

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/date.rst

Compares a user's creation date with the current date. This snippet demonstrates how to get the current date using the date function without arguments.

```html+twig
{% if date(user.created_at) < date() %}
    {# always! #}
{% endif %}
```

--------------------------------

### Twig Embed Tag Usage Examples

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/embed.rst

Demonstrates various ways to use the Twig embed tag, including passing variables, using the 'only' modifier, and ignoring missing templates. The embed tag takes the same arguments as the include tag.

```twig
{% embed "base" with {'name': 'Fabien'} %}
    ...
{% endembed %}
```

```twig
{% embed "base" with {'name': 'Fabien'} only %}
    ...
{% endembed %}
```

```twig
{% embed "base" ignore missing %}
    ...
{% endembed %}
```

--------------------------------

### Get Last Value of a Mapping

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/last.rst

Apply the 'last' filter to a mapping (associative array) to get the value associated with the last key. This works for retrieving the final entry in an object-like structure.

```twig
{{ {a: 1, b: 2, c: 3, d: 4}|last }}
{# outputs 4 #}
```

--------------------------------

### Enabling Sandbox Globally

Source: https://github.com/twigphp/twig/blob/3.x/doc/sandbox.rst

Enable sandbox mode for all templates by passing true as the second argument to the SandboxExtension constructor.

```php
$twig->addExtension(new \Twig\Extension\SandboxExtension($policy, true));
```

--------------------------------

### Basic Twig Template Structure

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Illustrates fundamental Twig syntax including HTML structure, for-loops for iterating over data, and variable output.

```html+twig
<!DOCTYPE html>
<html>
    <head>
        <title>My Webpage</title>
    </head>
    <body>
        <ul id="navigation">
        {% for item in navigation %}
            <li><a href="{{ item.href }}">{{ item.caption }}</a></li>
        {% endfor %}
        </ul>

        <h1>My Webpage</h1>
        {{ a_variable }}
    </body>
</html>
```

--------------------------------

### Get Random Character from String

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/random.rst

Returns a random character from a given string.

```twig
{{ random('ABC') }}                         {# example output: C #}
```

--------------------------------

### Using the format filter

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format.rst

Demonstrates how to use the 'format' filter to insert variables into a string. The placeholders '%s' are replaced by the subsequent arguments.

```twig
{% set fruit = 'apples' %}
{{ "I like %s and %s."|format(fruit, "oranges") }}

{# outputs I like apples and oranges #}
```

--------------------------------

### Basic JSON Encoding

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/json_encode.rst

Use the json_encode filter to get the JSON representation of a variable.

```twig
{{ data|json_encode() }}
```

--------------------------------

### Chaining u Filter Methods

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/u.rst

Demonstrates chaining multiple methods (wordwrap and upper) on the result of the 'u' filter for complex string manipulation.

```twig
{{ 'Symfony String + Twig = <3'|u.wordwrap(5).upper }}
```

--------------------------------

### Get Random Item from Sequence

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/random.rst

Returns a random item from a given sequence (e.g., an array).

```twig
{{ random(['apple', 'orange', 'citrus']) }} {# example output: orange #}
```

--------------------------------

### Get First Character of a String

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/first.rst

Apply the 'first' filter to a string to obtain its initial character.

```twig
{{ '1234'|first }}
{# outputs 1 #}
```

--------------------------------

### Twig API Usage with FilesystemLoader and Cache

Source: https://github.com/twigphp/twig/blob/3.x/doc/intro.rst

Shows how to use Twig with a FilesystemLoader to load templates from a directory and configure a compilation cache.

```php
$loader = new \Twig\Loader\FilesystemLoader('/path/to/templates');
$twig = new \Twig\Environment($loader, [
    'cache' => '/path/to/compilation_cache',
]);

echo $twig->render('index.html.twig', ['name' => 'Fabien']);
```

--------------------------------

### Simulating Inheritance with Renaming and parent()

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/use.rst

Illustrates a technique to simulate inheritance by renaming an imported block and then calling it using the 'block()' function within an overridden block.

```twig
{% extends "base.html.twig" %}

{% use "blocks.html.twig" with sidebar as parent_sidebar %}

{% block sidebar %}
    {{ block('parent_sidebar') }}
{% endblock %}
```

--------------------------------

### Currency Formatting with Fraction Digit Constraints

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_currency.rst

Formats a number as currency, applying constraints to the fraction part (min and max digits). Requires the IntlExtension.

```twig
{# €123.46 #}
{{ 123.456789 | format_currency('EUR', {max_fraction_digit:2, min_fraction_digit:1}, 'en') }}
```

--------------------------------

### Get Random Integer Up To Max

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/random.rst

Returns a random integer between 0 and the specified maximum value (inclusive).

```twig
{{ random(5) }}                             {# example output: 3 #}
```

--------------------------------

### Get current locale names

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/locale_names.rst

Returns the names of locales based on the current locale. Requires the IntlExtension.

```twig
{# Afrikaans, Afrikaans (Namibia), ... #}
{{ locale_names()|join(', ') }}
```

--------------------------------

### Basic Usage of Default Filter

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/default.rst

Demonstrates how to use the default filter to provide fallback values for undefined or empty variables.

```twig
{{ var|default('var is not defined') }}

{{ user.name|default('name item on user is not defined') }}

{{ user['name']|default('name item on user is not defined') }}

{{ ''|default('passed var is empty')  }}
```

--------------------------------

### Currency Formatting with Options

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_currency.rst

Formats a number as currency with custom attributes like rounding mode and fraction digits. Requires the IntlExtension.

```twig
{# €12.34 #}
{{ '12.345'|format_currency('EUR', {rounding_mode: 'floor'}) }}
```

```twig
{# €1,000,000.0000 #}
{{ '1000000'|format_currency('EUR', {fraction_digit: 4}) }}
```

--------------------------------

### Get Country Name with Explicit Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/country_name.rst

Returns the country name for a specified locale. Requires the IntlExtension.

```twig
{# États-Unis #}
{{ 'US'|country_name('fr') }}
```

```twig
{# 美國 #}
{{ 'US'|country_name('zh_Hant_HK') }}
```

--------------------------------

### Basic Twig API Usage with ArrayLoader

Source: https://github.com/twigphp/twig/blob/3.x/doc/intro.rst

Demonstrates basic Twig API usage by rendering a template stored in an array. Requires Twig autoloader.

```php
require_once '/path/to/vendor/autoload.php';

$loader = new \Twig\Loader\ArrayLoader([
    'index' => 'Hello {{ name }}!',
]);
$twig = new \Twig\Environment($loader);

echo $twig->render('index', ['name' => 'Fabien']);
```

--------------------------------

### Twig Inline Comments

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Shows the use of inline comments starting with '#' within Twig expressions and data structures.

```twig
{{ 
        # this is an inline comment
        "Hello World"|upper
        # this is an inline comment
    }}
```

```twig
{{ 
        {
            # this is an inline comment
            fruit: 'apple', # this is an inline comment

```

--------------------------------

### Basic Include Statement

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/include.rst

Includes 'header.html.twig' and 'footer.html.twig' in the current template.

```twig
{% include 'header.html.twig' %}
    Body
{% include 'footer.html.twig' %}
```

--------------------------------

### Configuring a Security Policy

Source: https://github.com/twigphp/twig/blob/3.x/doc/sandbox.rst

Create a SecurityPolicy instance to define allowed tags, filters, methods, properties, and functions. This policy is passed to the SandboxExtension constructor to manage security.

```php
$tags = ['if'];
    $filters = ['upper'];
    $methods = [
        'Article' => ['getTitle', 'getBody'],
    ];
    $properties = [
        'Article' => ['title', 'body'],
    ];
    $functions = ['range'];
    $policy = new \Twig\Sandbox\SecurityPolicy($tags, $filters, $methods, $properties, $functions);
```

--------------------------------

### Range with Negative Step

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/range.rst

Generates a sequence in descending order when the start is greater than the end. Assumes a step of -1.

```twig
{% for i in range(3, 0) %}
    {{ i }},
{% endfor %}

{# outputs 3, 2, 1, 0, #}
```

--------------------------------

### Dynamic Inheritance with List of Templates

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/extends.rst

Demonstrates using a list of template names for inheritance. Twig will use the first template in the list that exists.

```twig
{% extends ['layout.html.twig', 'base_layout.html.twig'] %}
```

--------------------------------

### Registering a Custom Extension

Source: https://github.com/twigphp/twig/blob/3.x/doc/advanced.rst

Demonstrates how to register a custom Twig extension with the main Environment object. This makes the extension's functionality available in Twig templates.

```php
$twig = new \Twig\Environment($loader);
$twig->addExtension(new CustomTwigExtension());
```

--------------------------------

### Spacing around delimiters

Source: https://github.com/twigphp/twig/blob/3.x/doc/coding_standards.rst

Ensure exactly one space after the start of a delimiter and before the end of a delimiter for non-empty content.

```twig
{{ user }}
{# comment #} {##}
{% if user %}{% endif %}
```

```twig
{{- user -}}
{#- comment -#} {#--#}
{%- if user -%}{%- endif -%}
```

--------------------------------

### Get Random Integer Between Two Values

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/random.rst

Returns a random integer between the first and second integer parameters (inclusive).

```twig
{{ random(50, 100) }}                       {# example output: 63 #}
```

--------------------------------

### Get Country Name with Default Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/country_name.rst

Returns the country name using the current locale. Requires the IntlExtension.

```twig
{# France #}
{{ 'FR'|country_name }}
```

--------------------------------

### Formatting with Percent Style

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_number.rst

Formats a number as a percentage, showing the value multiplied by 100 and followed by a percent sign.

```twig
{# 12% #}
{{ 0.1234 | format_number(style: 'percent', locale: 'en') }}
```

--------------------------------

### Basic Template Inheritance

Source: https://github.com/twigphp/twig/blob/3.x/doc/tags/use.rst

Demonstrates the fundamental structure of template inheritance in Twig, extending a base template and defining blocks.

```twig
{% extends "base.html.twig" %}

{% block title %}{% endblock %}
{% block content %}{% endblock %}
```

--------------------------------

### Display Node Tree

Source: https://github.com/twigphp/twig/blob/3.x/doc/internals.rst

Get a string representation of a Twig node tree (AST). Useful for debugging the parser output.

```text
\Twig\Node\ModuleNode(
  \Twig\Node\TextNode(Hello )
  \Twig\Node\PrintNode(
    \Twig\Node\Expression\NameExpression(name)
  )
)
```

--------------------------------

### Get Timezones for a Country

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/country_timezones.rst

Displays the timezones associated with the country code 'FR', joined by a comma and space. Requires the IntlExtension.

```twig
{# Europe/Paris #}
{{ country_timezones('FR')|join(', ') }}
```

--------------------------------

### Include from a List of Templates

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/include.rst

Checks a list of templates for existence and renders the first one found. If none exist and ignore_missing is true, returns an empty string; otherwise, throws an exception.

```twig
{{ include(['page_detailed.html.twig', 'page.html.twig']) }}
```

--------------------------------

### Formatting Math Calculations

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/number_format.rst

Shows how to format the result of a math calculation. Parentheses are necessary to ensure the calculation is performed before formatting due to operator precedence.

```twig
{{ 1 + 0.2|number_format(2) }} {# outputs : 1.2 #}
```

```twig
{{ (1 + 0.2)|number_format(2) }} {# outputs : 1.20 #}
```

--------------------------------

### Using a lipsum function

Source: https://github.com/twigphp/twig/blob/3.x/doc/advanced.rst

Demonstrates the correct usage of a 'lipsum' function in Twig, suitable for content generation within expressions.

```twig
{{ lipsum(40) }}
```

--------------------------------

### Generate Data URI for Image Data

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/data_uri.rst

Use this snippet to generate a data URI for image data. Ensure the HtmlExtension is installed.

```html+twig
{{ image_data|data_uri }}
```

--------------------------------

### Get Random Integer (No Arguments)

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/random.rst

When called without arguments, it returns a random integer, similar to PHP's mt_rand() function.

```twig
{{ random() }}                              {# example output: 15386094 (works as the native PHP mt_rand function) #}
```

--------------------------------

### Command Line Upload to Blackfire

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Uploads a generated profile file to Blackfire.io using the command-line interface.

```sh
blackfire --slot=7 upload /path/to/profile.prof
```

--------------------------------

### Get locale names for a specific locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/locale_names.rst

Returns the names of locales for a specified locale code (e.g., 'fr'). Requires the IntlExtension.

```twig
{# afrikaans, afrikaans (Afrique du Sud), ... #}
{{ locale_names('fr')|join(', ') }}
```

--------------------------------

### Currency Formatting with Padding

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_currency.rst

Formats a number as currency, setting the width and position for padding. Requires the IntlExtension.

```twig
{# €123.00 #}
{{ 123 | format_currency('EUR', {format_width:10, padding_position:'before_suffix'}, 'en') }}
```

--------------------------------

### Get language names for a specific locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/language_names.rst

This snippet demonstrates how to retrieve language names for a specific locale, in this case, French ('fr').

```twig
{# abkhaze, aceh, ... #}
{{ language_names('fr')|join(', ') }}
```

--------------------------------

### Calling Object Method with Arguments

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/attribute.rst

This snippet demonstrates how to call an object's method with arguments, where the method name is dynamic. The 'arguments' should be provided as an array.

```twig
{{ attribute(object, method_name, arguments) }}
```

--------------------------------

### Null-Coalescing Operator Example

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Illustrates the null-coalescing operator (??) which returns the first operand if it is defined and not null, otherwise it returns the second operand.

```twig
{# returns the value of result if it is defined and not null, 'no' otherwise #}
{{ result ?? 'no' }}
```

--------------------------------

### Enable StringLoaderExtension in Symfony (PHP)

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/template_from_string.rst

Configuration for enabling the StringLoaderExtension in Symfony projects via services.php.

```php
$services->set(\\Twig\\Extension\\StringLoaderExtension::class);
```

--------------------------------

### Twig Test Operator for Odd Numbers

Source: https://github.com/twigphp/twig/blob/3.x/doc/templates.rst

Checks if a variable holds an odd value. This is an example of using the 'is' operator for tests.

```twig
{# find out if a variable is odd #}

{{ name is odd }}
```

--------------------------------

### Optimizer Extension with Specific Optimizations

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Initializes the Optimizer extension to enable only specific optimizations, such as optimizing the 'for' tag.

```php
$optimizer = new \Twig\Extension\OptimizerExtension(\Twig\NodeVisitor\OptimizerNodeVisitor::OPTIMIZE_FOR);

    $twig->addExtension($optimizer);
```

--------------------------------

### Twig FilterExpression node deprecation

Source: https://github.com/twigphp/twig/blob/3.x/doc/deprecated.rst

The 'filter' node of Twig\Node\Expression\FilterExpression is deprecated and will be removed in 4.0. Use the 'filter' attribute instead to get the filter.

```php
$node->getNode('filter')->getAttribute('value')
```

```php
$node->getAttribute('twig_callable')->getName()
```

--------------------------------

### Display Token Stream

Source: https://github.com/twigphp/twig/blob/3.x/doc/internals.rst

Get a textual representation of a Twig token stream by echoing the stream object. Useful for debugging the lexer output.

```text
TEXT_TYPE(Hello )
VAR_START_TYPE()
NAME_TYPE(name)
VAR_END_TYPE()
EOF_TYPE()
```

--------------------------------

### Apply html_to_markdown with Options

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/html_to_markdown.rst

Pass options to the html_to_markdown filter to customize conversion, shown here for league/html-to-markdown.

```html+twig
{% apply html_to_markdown({hard_break: false}) %}
    <html>
        <h1>Hello!</h1>
    </html>
{% endapply %}
```

--------------------------------

### Streaming Templates

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Explains how to stream template content, which is useful for large templates or when memory is a concern.

```APIDOC
## Streaming Templates

### Description
This section describes how to stream template content, which returns an iterable and is suitable for large templates or memory-constrained environments.

### Method
- `stream(array $context = [])` on \Twig\TemplateWrapper
- `streamBlock(string $name, array $context = [])` on \Twig\TemplateWrapper

### Endpoint
N/A (PHP API)

### Parameters
#### TemplateWrapper::stream()
- **context** (*array*) - Required - An associative array of variables to pass to the template.

#### TemplateWrapper::streamBlock()
- **name** (*string*) - Required - The name of the block to stream.
- **context** (*array*) - Required - An associative array of variables to pass to the template.

### Request Example
```php
// Streaming a template
foreach ($template->stream(['the' => 'variables', 'go' => 'here']) as $chunk) {
    echo $chunk;
}

// Streaming a specific block
foreach ($template->streamBlock('block_name', ['the' => 'variables', 'go' => 'here']) as $chunk) {
    echo $chunk;
}
```

### Response
#### Success Response
- **Iterable** - An iterable that yields chunks of the rendered template content.
```

--------------------------------

### Get Country Names in Default Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/country_names.rst

Returns a list of country names using the current locale. Join them with a comma and space for display.

```twig
{# Afghanistan, Åland Islands, ... #}
{{ country_names()|join(', ') }}
```

--------------------------------

### ArrayLoader for templates

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Initialize an ArrayLoader with a map of template names to their content. This is useful for unit testing or small projects.

```php
$loader = new \Twig\Loader\ArrayLoader([
    'index.html.twig' => 'Hello {{ name }}!',
]);
$twig = new \Twig\Environment($loader);

echo $twig->render('index.html.twig', ['name' => 'Fabien']);
```

--------------------------------

### Retrieving Fully Qualified Class Name

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/constant.rst

Use the 'constant' function with the 'class' argument to get the fully qualified class name of an object.

```twig
{{ constant('class', date) }}
```

--------------------------------

### Get Language Name in Specific Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/language_name.rst

Returns the language name for the given ISO code, translated into the specified locale. Requires the IntlExtension.

```twig
{# allemand #}
{{ 'de'|language_name('fr') }}
```

```twig
{# français canadien #}
{{ 'fr_CA'|language_name('fr_FR') }}
```

--------------------------------

### Load and Render a Twig Template Directly

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Loads and renders a Twig template directly using the Environment object.

```php
echo $twig->render('index.html.twig', ['the' => 'variables', 'go' => 'here']);
```

--------------------------------

### FilesystemLoader with namespaced paths

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Add a template directory to a specific namespace using addPath. Namespaced templates are accessed using the '@namespace/template' notation.

```php
$loader->addPath($templateDir, 'admin');
```

--------------------------------

### Get Language Name in Default Locale

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/language_name.rst

Returns the language name for the given ISO code using the current locale. Requires the IntlExtension.

```twig
{# German #}
{{ 'de'|language_name }}
```

--------------------------------

### Get Last Element of an Array

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/last.rst

Use the 'last' filter to retrieve the last element from an array. This is useful when you need the final value in a list.

```twig
{{ [1, 2, 3, 4]|last }}
{# outputs 4 #}
```

--------------------------------

### Formatting as Percent

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_number.rst

Formats a number as a percentage. This is a shortcut for `format_number(style: 'percent')`.

```twig
{# 1,234% #}
{{ '12.345'|format_number(style: 'percent') }}
```

```twig
{# 12.3% #}
{{ '0.12345'|format_percent_number({rounding_mode: 'floor', fraction_digit: 1}) }}
```

--------------------------------

### Configure Twig Environment with Debug Mode

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Creates a Twig environment instance with the debug option enabled.

```php
$twig = new 
\Twig\Environment($loader, ['debug' => true]);
```

--------------------------------

### Get First Value of an Associative Array/Map

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/first.rst

The 'first' filter can also be applied to associative arrays (maps) to retrieve the value of the first key-value pair.

```twig
{{ {a: 1, b: 2, c: 3, d: 4}|first }}
{# outputs 1 #}
```

--------------------------------

### Load a Twig Template

Source: https://github.com/twigphp/twig/blob/3.x/doc/api.rst

Loads a Twig template from the configured environment, returning a TemplateWrapper instance.

```php
$template = $twig->load('index.html.twig');
```

--------------------------------

### Registering the Sandbox Extension

Source: https://github.com/twigphp/twig/blob/3.x/doc/sandbox.rst

Register the SandboxExtension with the Twig environment using the addExtension() method. This requires a policy instance to be passed to the constructor.

```php
$twig->addExtension(new \Twig\Extension\SandboxExtension($policy));
```

--------------------------------

### Custom Date-Time Pattern

Source: https://github.com/twigphp/twig/blob/3.x/doc/filters/format_datetime.rst

Applies a custom ICU pattern for flexible date and time formatting. This example shows a custom pattern for time and timezone.

```twig
{{ '2019-08-07 23:39:12'|format_datetime(pattern: "hh 'oclock' a, zzzz") }}
```

--------------------------------

### Dump all context variables

Source: https://github.com/twigphp/twig/blob/3.x/doc/functions/dump.rst

If no arguments are provided, the dump function will output all variables available in the current template context.

```twig
{{ dump() }}
```