TwigBridge

https://github.com/rcrowe/twigbridge
Admin
TwigBridge seamlessly integrates the Twig templating engine with the Laravel PHP framework,...
Tokens:44,139
Snippets:393
Trust Score:9.4
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Lumen bootstrap example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

Example from README showing how to configure and register the TwigBridge ServiceProvider in a Lumen application.

```php
// bootstrap/app.php
$app->configure('twigbridge');
$app->register('TwigBridge\ServiceProvider');
```

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

### Basic rendering with twig.engine

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Example of basic rendering through the engine. Normally you would use the view() helper instead. Retrieves the engine from the container and calls get() with a template path and data array.

```php
$engine = app('twig.engine');
$html   = $engine->get('/var/www/resources/views/welcome.twig', ['name' => 'Ada']);
```

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

### Basic load() example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Loads a template and renders it with data.

```php
$compiler = app('twig.compiler');
$wrapper  = $compiler->load('emails/receipt');   // Twig\TemplateWrapper
$html     = $wrapper->render(['order' => $order]);
```

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

### Laravel Route Definition

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

Example route that triggers the rendering of the 'welcome' view.

```php
// routes/web.php
Route::get('/', fn () => view('welcome'));
```

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

### Auth extension Twig example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Example Twig template using auth_check(), auth_user(), and auth_guest() to display user-specific content.

```twig
{% if auth_check() %}Welcome back, {{ auth_user().name }}{% else %}Hello, guest{% endif %}
{% if auth_guest() %}<a href="/login">Log in</a>{% endif %}
```

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

### Basic lint usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Example of checking if a template has valid syntax.

```php
$twig = app('twig');

if ($twig->lint('newsletter.twig')) {
    // template syntax is valid
}
```

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

### get() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Method signature for get(), which renders a Twig template at the given path with optional view variables.

```php
public function get($path, array $data = [])
```

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

### Example of running artisan twig

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Shows the command invocation and expected output for the 'twig' Artisan command.

```bash
$ php artisan twig
Twig version       3.21.0
Twig Bridge version 0.10.0
```

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

### Create a Twig Template

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Example of a Twig template file located in the resources/views directory.

```html
<!-- resources/views/welcome.twig -->
<h1>
  Welcome to TwigBridge!
</h1>
```

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

### get() method implementation

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Implementation of the get() method. Merges global data first, then per-view data (per-view wins), loads and renders the template, and catches Twig\Error\Error to call handleTwigError(). Returns the rendered HTML string.

```php
$data = array_merge($this->globalData, $data);

try {
    $content = $this->compiler->load($path)->render($data);
} catch (Error $ex) {
    $this->handleTwigError($ex);
}

return $content;
```

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

### Use Twig Facade for Extensions and Rendering

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Example of adding an extension and rendering a template using the Twig Facade.

```php
Twig::addExtension('TwigBridge\Extension\Loader\Functions');
Twig::render('mytemplate', $data);
```

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

### Twig dump usage example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Example of using the dump function in Twig templates. No output unless twig.debug is enabled.

```twig
{{ dump() }}
{{ dump(user, order.items) }}
```

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

### Gate extension Twig example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Example Twig template using the can() function to conditionally display an edit link.

```twig
{% if can('update', post) %}
    <a href="{{ route('posts.edit', post) }}">Edit</a>
{% endif %}
```

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

### Legacy Facades configuration and usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Enabling the Legacy Facades extension in the configuration and example usage in Twig templates.

```php
// config/twigbridge.php
'enabled' => [
    'TwigBridge\Extension\Laravel\Legacy\Facades',
],
// alias_shortcuts: 'twigbridge.alias_shortcuts' (read in the constructor)
```

```twig
{{ auth_check() }}       {# Auth::check() #}
{{ url_to('/home') }}    {# Url::to() #}
```

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

### Example of running artisan twig:clean

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Shows the command invocation and expected output for the 'twig:clean' Artisan command. Run after changing config/twigbridge.php to rebuild stale compiled templates.

```bash
$ php artisan twig:clean
Twig cache cleaned
```

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

### Config Extension Usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Examples of using the config, config_get, and config_has functions within a Twig template.

```twig
{{ config('app.name') }}
{{ config_get('mail.from.address') }}
{% if config_has('services.stripe') %}...{% endif %}
```

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

### Laravel View Composer Registration

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

Example of registering a view composer that EventNode will trigger when rendering the 'welcome' template.

```php
// anywhere in the app
View::composer('welcome', function ($view) {
    $view->with('pageTitle', 'Welcome');
});
```

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

### validate() return records

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Example return records from validate() for valid and invalid templates.

```php
// valid template:
['template' => $template, 'file' => $file, 'valid' => true]
// invalid template (Twig\Error\Error caught):
['template' => $template, 'file' => $file, 'valid' => false, 'exception' => $e]
```

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

### Facade configuration and Twig usage example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Shows how to configure facades in config/twigbridge.php, including safe methods, and then use them in Twig templates. The Config facade is called directly, while Form.open is marked safe.

```php
// config/twigbridge.php
'facades' => [
    'Config' => Illuminate\Support\Facades\Config::class,
    'Form' => [
        'is_safe' => ['open', 'close'],
    ],
],
```

```twig
{{ Config.get('app.timezone') }}
{{ Form.open({action: '/login'}) }}
```

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

### Example: View::share and Twig usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Shows how to share a variable with View::share and then access it in Twig, along with the 'app' and 'errors' globals provided by the Globals loader.

```php
View::share('siteName', 'Example');
```

```twig
{{ app.environment }}
{{ errors.first('email') }}
{{ siteName }}
```

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

### Manual Bridge construction

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Example of manually constructing the Bridge class, though resolving the twig binding is preferred.

```php
use Illuminate	extbackslashFilesystem	extbackslashFilesystem;
use Illuminate	extbackslashView	extbackslashFileViewFinder;
use TwigBridge	extbackslashBridge;
use TwigBridge	extbackslashTwig	extbackslashLoader;

$finder = new FileViewFinder(new Filesystem, [resource_path('views')]);
$loader = new Loader(new Filesystem, $finder, 'twig');

$bridge = new Bridge($loader, ['debug' => true, 'cache' => storage_path('framework/views/twig')]);
```

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

### TwigBridge\Extension\Laravel\Url Usage Example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Demonstrates using URL generation functions in a Twig template.

```twig
{{ asset('css/app.css') }}
{{ route('tasks.edit', task.id) }}
{{ url('dashboard') }}
{{ secure_url('account') }}
{{ secure_asset('img/logo.png') }}
{% if route_has('tasks.edit') %}...{% endif %}
{{ url_current() }}  {# via url_* wildcard #}
```

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

### Lint error handling

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Example of handling an InvalidArgumentException when a file cannot be found during linting.

```php
try {
    // File does not exist on the view paths
    $valid = app('twig')->lint('does-not-exist');
} catch (InvalidArgumentException $e) {
    echo $e->getMessage(); // "Unable to find file: does-not-exist"
}
```

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

### Resolving Bridge from container

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Example of using the Twig facade and direct container access to interact with the bridge.

```php
use TwigBridge	extbackslashFacade	extbackslashTwig;

// Facade proxies the 'twig' container binding
Twig::addExtension('TwigBridge	extbackslashExtension	extbackslashLoader	extbackslashFunctions');
$rendered = Twig::render('mytemplate', ['name' => 'Rob']);

// Direct access
$bridge = app('twig');            // TwigBridge	extbackslashBridge
$container = app('twig')->getApplication();
```

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

### Error handling example for load()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Catches InvalidArgumentException and retrieves the original Twig\Error\LoaderError.

```php
use Illuminate\View\Compilers\CompilerInterface;
use InvalidArgumentException;

try {
    app('twig.compiler')->load('emails/missing');
} catch (InvalidArgumentException $e) {
    $previous = $e->getPrevious(); // original Twig\Error\LoaderError
}
```

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

### Define Global Variables in Configuration

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/configuration.md

Example of defining global variables within the twig.globals array in the configuration file.

```php
'twig' => [
    'globals' => [
        'site_name' => 'Acme',
    ],
],
```

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

### Input Extension Usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Examples of using the old, input_get, and input_has functions within a Twig template for form handling.

```twig
<input name="email" value="{{ old('email', input_get('email')) }}">
{% if input_has('page') %}Page {{ input_get('page') }}{% endif %}
```

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

### TwigBridge\Extension\Laravel\Str Usage Example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Demonstrates using string filters and functions in a Twig template.

```twig
{{ "some_string"|camel_case }}
{{ "SomeString"|snake_case }}
{{ "some text"|studly_case }}
{{ str_upper('hello') }}
{{ "hello world"|str_title }}
```

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

### Former Twig Template Usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Example of using Former methods within a Twig template using the former_* prefix.

```twig
{{ former_open('/users') }}
{{ former_text('username') }}
{{ former_submit('Save') }}
```

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

### Capturing render failures with ErrorException

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Example of capturing render failures with exact file and line information. Catches ErrorException for resolved template files and Twig\Error\Error for cases where source context is unavailable.

```php
use ErrorException;
use Twig\Error\Error;

try {
    app('twig.engine')->get($path, $data);
} catch (ErrorException $e) {
    // $e->getFile() and $e->getLine() point at the .twig source
    report($e);
} catch (Error $e) {
    // re-thrown verbatim when the source context is unavailable
}
```

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

### Install TwigBridge via Composer

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Use Composer to add the TwigBridge package to your Laravel project.

```bash
composer require rcrowe/twigbridge
```

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

### Twig Translation Usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Examples of using the trans and trans_choice functions and filters within Twig templates.

```twig
{{ trans('messages.welcome', {'name': user.name}) }}
{{ trans_choice('messages.apples', count) }}
{{ 'messages.greeting'|trans({'name': user.name}) }}
```

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

### Vite Twig Function Usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Example of using the vite function in a Twig template to include assets.

```twig
{{ vite(['resources/css/app.css', 'resources/js/app.js']) }}
```

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

### Filter configuration and Twig usage example

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Shows how to configure a custom filter in config/twigbridge.php with a renamed callback, and then use it in a Twig template. The filter 'snake' maps to the 'snake_case' helper.

```php
// config/twigbridge.php
'filters' => [
    'snake' => [
        'callback' => 'snake_case',
    ],
],
```

```twig
{{ "Hello World"|snake }}
```

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

### TwigBridge Laravel Form usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Example of using the form_* Twig functions provided by the Laravel Form extension.

```twig
{{ form_open({'url': '/tasks', 'method': 'post'}) }}
{{ form_label('title', 'Title') }}
{{ form_text('title') }}
{{ form_submit('Save') }}
{{ form_close() }}
```

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

### HTML Twig Functions Usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Examples of using various link generation functions provided by the HTML extension in Twig templates.

```twig
{{ link_to('tasks', 'Tasks') }}
{{ link_to_route('tasks.edit', 'Edit', task.id, {'class': 'btn btn-primary'}) }}
{{ link_to_action('TaskController@index', 'Tasks') }}
```

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

### Session Extension Usage

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Examples of using session functions and Laravel helpers like csrf_field and method_field within a Twig form.

```twig
<form method="post" action="/profile">
    {{ csrf_field() }}
    {{ method_field('PUT') }}
    {% if session_has('status') %}<p>{{ session_get('status') }}</p>{% endif %}
</form>
```

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

### boot() method

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

The boot() method loads configuration and registers the .twig view extension.

```php
public function boot()
{
    $this->loadConfiguration();
    $this->registerExtension();
}
```

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

### Initialize Twig Loader

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/twig-loader.md

Demonstrates manual instantiation of the Twig Loader using a FileViewFinder and Filesystem.

```php
use Illuminate\Filesystem\Filesystem;
use Illuminate\View\FileViewFinder;
use TwigBridge\Twig\Loader;

$finder = new FileViewFinder(new Filesystem, [resource_path('views')]);
$loader = new Loader(new Filesystem, $finder, 'twig');

var_dump($loader->exists('welcome'));            // true
$source = $loader->getSourceContext('welcome');  // Twig\Source
echo $source->getCode();
```

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

### register() method

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

The register() method wires all IoC bindings by calling several registration methods. It is called before boot().

```php
public function register()
{
    $this->registerCommands();
    $this->registerOptions();
    $this->registerLoaders();
    $this->registerEngine();
    $this->registerAliases();
}
```

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

### Overriding extension with closure in config

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

Example showing how to override an extension using a closure in the twigbridge config. The closure receives $app and $twig and must return an extension instance. If the closure throws, the exception is wrapped in InvalidArgumentException.

```php
// config/twigbridge.php
'enabled' => [
    'TwigBridge\Extension\Laravel\Auth',
    function ($app, $twig) {
        return new Assetic\Extension\Twig\AsseticExtension(
            new Assetic\Factory\AssetFactory($app['path'] . '/../some/path/')
        );
    },
],
```

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

### Configure extensions.facades

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/configuration.md

Exposes configured facades as Twig globals. The array maps the facade name to its class or an options array.

```php
'facades' => [
    'Config' => 'Illuminate\Support\Facades\Config',
    'Form' => [
        'is_safe' => ['open', 'close'],
    ],
],
```

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

### Rendering Templates and Adding Extensions

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Demonstrates adding a Twig extension and rendering a template using the Twig facade.

```php
use TwigBridge\Facade\Twig;

Twig::addExtension('TwigBridge\Extension\Loader\Functions');
$html = Twig::render('mytemplate', ['items' => collect([1, 2, 3])]);
```

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

### getApplication method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Returns the Laravel container instance.

```php
public function getApplication()
```

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

### Former Extension Constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

The constructor for the Former extension requires an instance of the Former library.

```php
public function __construct(\Former\Former $former)
```

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

### Loader constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/twig-loader.md

Initializes the loader with the Laravel filesystem, view finder, and the template file extension.

```php
public function __construct(Filesystem $files, ViewFinderInterface $finder, $extension = 'twig')
```

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

### Compiler constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Constructor that accepts a Twig\Environment instance.

```php
public function __construct(Environment $twig)
```

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

### provides() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

Public method that returns the array of container keys this provider contributes.

```php
public function provides()
```

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

### Twig Template Variable Injection

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

Example of accessing the variable injected by the view composer within a Twig template.

```twig
<h1>{{ pageTitle }}</h1>   {# injected by the composer via EventNode #}
```

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

### Input Extension Constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

The constructor for the Input extension requires an instance of Illuminate\Http\Request.

```php
public function __construct(Request $request)
```

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

### Handle Missing Templates

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/twig-loader.md

Shows how to catch a LoaderError when attempting to find a template that does not exist.

```php
use Twig\Error\LoaderError;

try {
    $path = $loader->findTemplate('admin/reports/missing');
} catch (LoaderError $e) {
    // thrown when the finder cannot locate the file
    echo $e->getMessage();
}
```

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

### trans function

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Twig function that calls Laravel's translator `get` method to translate a given key.

```APIDOC
## trans

### Description
Twig function that translates a message using Laravel's translator `get` method.

### Twig Function
`trans`

### Target Callable
`[$this->translator, 'get']`

### Parameters
- **key** (string) - Required - The translation key.
- **replace** (array) - Optional - An array of replacement values for placeholders.

### Example
```twig
{{ trans('messages.welcome', {'name': user.name}) }}
```
```

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

### Facade\Caller::getOptions()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Returns the merged options array with defaults for is_safe and charset.

```APIDOC
## Facade\Caller::getOptions()

### Description
Returns the options array after merging provided options with defaults `['is_safe' => null, 'charset' => null]`.

### Method Signature
`public function getOptions(): array`

### Return Value
- **array** - The merged options array. `is_safe` can be `true` (whole output safe) or an array of safe method names; `charset` is used for `Twig\Markup`.

### Example (PHP)
```php
$options = $caller->getOptions();
```
```

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

### compile() method

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Compiles the view, swallowing exceptions and hinting to run `php artisan twig:lint` on failure.

```php
public function compile($path)
```

```php
try {
    $this->load($path);
} catch (Exception $ex) {
    // Unable to compile — try running `php artisan twig:lint`
}
```

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

### provides() return array

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

The array of container keys returned by provides().

```php
[
    'command.twig', 'command.twig.clean', 'command.twig.lint',
    'twig.extension', 'twig.options', 'twig.extensions', 'twig.lexer',
    'twig.templates', 'twig.loader.array', 'twig.loader.viewfinder', 'twig.loader',
    'twig', 'twig.compiler', 'twig.engine',
]
```

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

### twig:lint command with default output

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Lints an entire project using default view paths. Output shows valid file count and exit code 1 on failure.

```bash
$ php artisan twig:lint
0/12 valid files          # exit code 1
```

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

### Access Global Variable in Twig Template

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/configuration.md

Example of accessing a global variable defined in the configuration file within a Twig template.

```twig
{{ site_name }}
```

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

### loadConfiguration() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

The protected method signature for loadConfiguration().

```php
protected function loadConfiguration()
```

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

### Enable Extensions via Closure

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Use a closure to implement complex extensions like Assetic.

```php
'enabled' => [
    function($app) {
        $factory = new Assetic\Factory\AssetFactory($app['path'].'/../some/path/');
        $factory->setDebug(false);
        // etc.....
        return new Assetic\Extension\Twig\AsseticExtension($factory);
    }
]
```

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

### handle() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Signature for the handle() method, which orchestrates the linting process.

```php
public function handle()
```

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

### Eloquent Access in Twig Templates

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

Example usage of accessing Eloquent model properties within Twig templates, which requires the GetAttrNode logic to handle magic properties.

```twig
{{ user.name }}
{{ user.profile.bio }}
{% if user.plan is defined %}...{% endif %}
{{ posts|first.title }}
```

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

### TwigBridge\Command\TwigBridge::handle() method

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Prints the Twig and TwigBridge version information to the console. Uses Environment::VERSION and Bridge::BRIDGE_VERSION.

```php
public function handle()
{
    $this->line('<info>Twig</info> version        <comment>'.Environment::VERSION.'</comment>');
    $this->line('<info>Twig Bridge</info> version <comment>'.Bridge::BRIDGE_VERSION.'</comment>');
}
```

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

### Dump constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Constructor for the Dump extension. No dependencies; creates a Symfony VarCloner internally.

```php
public function __construct()
```

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

### Render Package Views

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Render views located in other packages using the namespace syntax.

```php
View::make('pagination::simple')
```

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

### Config Extension Constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

The constructor for the Config extension requires an instance of Illuminate\Config\Repository.

```php
public function __construct(ConfigRepository $config)
```

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

### getTwig() method

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Returns the Twig environment passed to the constructor.

```php
public function getTwig()
```

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

### Loader constructor signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Constructor accepts the Laravel config repository. Concrete extensions read twigbridge.extensions.* from it.

```php
public function __construct(Config $config)
```

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

### Auth extension constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Constructor for the Auth extension, injecting the AuthManager instance.

```php
public function __construct(AuthManager $auth)
```

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

### twig

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Displays version information for Twig and TwigBridge. This command has no arguments or options and prints the versions to stdout.

```APIDOC
## [CLI] twig

### Description
Displays version information for Twig and TwigBridge.

### Method
CLI

### Endpoint
php artisan twig

### Parameters
None

### Request Example
php artisan twig

### Response
#### Success Response
- **stdout** (string) - Prints lines with Twig version and Twig Bridge version.

#### Response Example
Twig version       3.21.0
Twig Bridge version 0.10.0
```

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

### registerEngine() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

Protected method that binds 'twig' as a singleton TwigBridge\Bridge and performs heavy wiring, including safe classes, runtime loader, extensions, lexer, and aliases. Throws InvalidArgumentException for invalid extensions.

```php
protected function registerEngine()
```

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

### display() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Signature for the display() method, which renders the lint results.

```php
protected function display(array $details, $format = 'text')
```

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

### Session Extension Constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

The constructor for the Session extension requires an instance of Illuminate\Session\Store.

```php
public function __construct(Store $session)
```

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

### Twig::load()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Loads a Twig template. This is statically forwarded to the underlying Twig\Environment instance.

```APIDOC
## Twig::load()

### Description
Loads a Twig template by name. This is part of the Twig 3 public API and is accessible through the facade.

### Method
`load`

### Signature
`Twig::load(string $name)`

### Parameters
- **$name** (string) - Required - The name of the template to load.

### Response
Returns a `Twig\TemplateWrapper` instance representing the loaded template.
```

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

### Loader::__construct()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/twig-loader.md

Constructor for the Loader class. Initializes the loader with Laravel's filesystem abstraction, the view finder, and the Twig file extension to strip from names.

```APIDOC
## Loader::__construct()

### Description
Constructor for the Loader class. Initializes the loader with Laravel's filesystem abstraction, the view finder, and the Twig file extension to strip from names.

### Method
__construct

### Signature
public function __construct(Filesystem $files, ViewFinderInterface $finder, $extension = 'twig')

### Parameters
- **$files** (Illuminate\Filesystem\Filesystem) - Required - Laravel filesystem abstraction
- **$finder** (Illuminate\View\ViewFinderInterface) - Required - The view finder; the provider passes $app['view']->getFinder()
- **$extension** (string) - Optional - Twig file extension to strip from names. Default: 'twig'
```

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

### lint method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Checks the syntax of a template file.

```php
public function lint($file)
```

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

### isRunningOnPhp7() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

Protected method that returns true if PHP version is >= 7.0-dev.

```php
protected function isRunningOnPhp7()
```

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

### registerExtension() implementation

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

Registers the Twig file extension with the Laravel view factory. After this, view('welcome') renders resources/views/welcome.twig through TwigBridge\Engine\Twig.

```php
$this->app['view']->addExtension(
    $this->app['twig.extension'],   // 'twig' by default
    'twig',                          // engine resolver name
    function () {
        return $this->app['twig.engine'];
    }
);
```

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

### Manually Wiring the Model Extension

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

How to manually register the Model extension to ensure GetAttrExpression is compiled to GetAttrNode.

```php
use TwigBridge\Extension\Laravel\Model;

$twig = app('twig');
$twig->addExtension(new Model);
// every subsequent GetAttrExpression is now compiled to GetAttrNode::attribute()
```

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

### Publish TwigBridge Configuration

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Use the Artisan command to publish the package configuration file to your project.

```bash
php artisan vendor:publish --provider="TwigBridge\ServiceProvider"
```

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

### registerOptions() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

The protected method signature for registerOptions().

```php
protected function registerOptions()
```

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

### setApplication method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Sets the Laravel container instance on the bridge.

```php
public function setApplication(Container $app)
```

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

### Twig::render()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Renders a Twig template with the given context. This method is statically forwarded to the underlying Twig\Environment instance.

```APIDOC
## Twig::render()

### Description
Renders a Twig template with the provided context variables. This is a static call that proxies to the `twig` container binding.

### Method
`render`

### Signature
`Twig::render(string $name, array $context = [])`

### Parameters
- **$name** (string) - Required - The name of the template to render.
- **$context** (array) - Optional - An associative array of variables to pass to the template.

### Request Example
```php
Twig::render('mytemplate', ['items' => collect([1, 2, 3])]);
```

### Response
Returns the rendered template as a string.

### Error Handling
Throws `Twig\Error\RuntimeError` if the template cannot be rendered (e.g., missing template or runtime error).
```

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

### Configure extensions.functions

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/configuration.md

Defines latent functions exposed to Twig. Bare strings resolve to PHP/Laravel helpers, while arrays allow for custom TwigFunction options.

```php
'functions' => [
    'elixir',                       // elixir(...)
    'link' => [                     // named link_to aka Twig `link`
        'callback' => 'link_to',
    ],
    'link_to' => [
        'is_safe' => ['html'],
    ],
],
```

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

### load() method

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Loads a template and returns a Twig\TemplateWrapper, throwing InvalidArgumentException on failure.

```php
public function load($path)
```

```php
try {
    $tmplWrapper = $this->twig->load($path);
} catch (Exception $e) {
    throw new InvalidArgumentException("Error loading $path: " . $e->getMessage(), $e->getCode(), $e);
}
return $tmplWrapper;
```

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

### dump

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

The dump() function dumps template context variables or specific arguments as HTML. It is a no-op unless Twig debug mode is enabled.

```APIDOC
## dump

### Description
Dumps the entire template context or specific variables as HTML using Symfony VarDumper. Returns null when Twig debug mode is disabled.

### Method
Twig function

### Endpoint
`dump` (Twig function)

### Parameters
#### Injected Parameters
- `$env` (Twig\Environment) - Required - Twig environment (injected automatically)
- `$context` (array) - Required - Template context (injected automatically)

#### Additional Arguments
- `...$arguments` (mixed) - Optional - Variables to dump individually; if none provided, dumps the whole context.

### Request Example
```twig
{{ dump() }}
{{ dump(user, order.items) }}
```

### Response
#### Success Response (200)
- Returns a string of HTML output, or null if debug mode is disabled.

#### Response Example
```html
<!-- HTML dump output -->
```

### Error Handling
- Returns null (no output) when `! $env->isDebug()`.
```

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

### TwigBridge\Extension\Laravel\Legacy\Facades::__construct

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Constructor for the Legacy Facades extension, registers an undefined-function callback on the Twig environment.

```APIDOC
## TwigBridge\Extension\Laravel\Legacy\Facades::__construct

### Description
Constructs the extension with the application and config repositories, and registers a callback that resolves undefined Twig functions using alias lookup.

### Method
__construct

### Parameters
- `$app` (Illuminate\Foundation\Application) - Required - Application container
- `$config` (Illuminate\Config\Repository) - Required - Config repository

### Response
No return value.
```

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

### getShortcuts

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Returns the lowercase shortcut map.

```APIDOC
## getShortcuts

### Description
Returns the shortcut map with lowercased keys.

### Method
getShortcuts()

### Parameters
None

### Response
Returns the lowercase shortcut map.
```

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

### Gate extension constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-core.md

Constructor for the Gate extension, injecting the GateContract instance.

```php
public function __construct(GateContract $gate)
```

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

### exists()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/twig-loader.md

Checks whether a template exists by attempting to find it. Returns true if found, false if a LoaderError is thrown.

```APIDOC
## exists()

### Description
Checks whether a template exists by attempting to find it. Returns true if found, false if a LoaderError is thrown.

### Method
exists

### Signature
public function exists($name)

### Parameters
- **$name** (string) - Required - Template name

### Return
bool - true if findTemplate() succeeds, false if it throws LoaderError.
```

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

### registerCommands() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

The protected method signature for registerCommands().

```php
protected function registerCommands()
```

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

### Render a Twig View in Routes

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Use the standard Laravel view helper to render a Twig template.

```php
// routes/web.php

use Illuminate\Support\Facades\Route;

Route::get('/', static function () {
    return view('welcome');
});
```

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

### Facade Caller __call method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Magic method that proxies calls to the facade. Takes the method name and arguments array.

```php
public function __call($method, array $arguments)
```

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

### Output Variables and Filters

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Display variables with default escaping, or use the raw filter to bypass it.

```html
{{ some_var }}
{{ html_var | raw }}
{{ long_var | str_limit(50) }}
```

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

### isLumen() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

Protected method that returns true when the application version contains 'Lumen'. On Lumen, config is not published and certain extensions should be disabled.

```php
protected function isLumen()
```

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

### Facade\Caller::__call($method, $arguments)

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Dynamically calls a method on the configured facade, optionally wrapping the result in Twig\Markup if marked as safe.

```APIDOC
## Facade\Caller::__call($method, $arguments)

### Description
Proxies calls to the configured facade using `forward_static_call_array([$this->facade, $method], $arguments)`. If the method is marked as safe (via `is_safe` option) and the result is a string or has `__toString`, it is wrapped in `Twig\Markup` to prevent escaping.

### Method Signature
`public function __call($method, array $arguments)`

### Parameters
- **method** (string) - Required - Name of the facade method to call.
- **arguments** (array) - Required - Arguments to pass to the facade method.

### Return Value
- **mixed** - The result from the facade call, potentially wrapped in `Twig\Markup`.

### Example (Twig)
```twig
{{ Config.get('app.timezone') }}
{{ Form.open({action: '/login'}) }}
```

### Notes
- If `is_safe` is `true` or an array containing the method, and the result is a string/object with `__toString`, the output is wrapped in `Twig\Markup($result, $this->options['charset'])`.
- Otherwise, the raw result is returned.
```

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

### setShortcuts

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

Sets the shortcut map with lowercased keys.

```APIDOC
## setShortcuts

### Description
Sets the shortcut-to-alias map, converting all keys to lowercase.

### Method
setShortcuts(array $shortcuts)

### Parameters
- `$shortcuts` (array) - Required - Shortcut map to set

### Response
void
```

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

### HTML Extension Constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

The constructor for the HTML extension, which requires the Collective HTML builder.

```php
public function __construct(HtmlBuilder $html)
```

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

### Vite Extension Constructor

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-laravel-output.md

The constructor for the Vite extension, which requires an instance of Laravel's Vite helper.

```php
public function __construct(IlluminateVite $vite)
```

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

### getContext() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Signature for the getContext() method that returns a map of line numbers to source lines for error context.

```php
protected function getContext(Source $template, $line, $context = 3)
```

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

### Twig::addExtension()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Adds a Twig extension to the environment. This is statically forwarded to the underlying Twig\Environment instance.

```APIDOC
## Twig::addExtension()

### Description
Registers a Twig extension with the environment. This allows adding custom functions, filters, and other Twig features.

### Method
`addExtension`

### Signature
`Twig::addExtension(Twig\Extension\ExtensionInterface $extension)`

### Parameters
- **$extension** (Twig\Extension\ExtensionInterface) - Required - The extension instance to add.

### Request Example
```php
Twig::addExtension('TwigBridge\Extension\Loader\Functions');
```

### Response
No return value (void).
```

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

### twig:lint command with JSON output and its response

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Lints from a script with JSON output. The command outputs a JSON array with file, valid, and message fields.

```bash
printf '{{ bad syntax }' | php artisan twig:lint --format=json
```

```json
[
    {
        "file": "",
        "valid": false,
        "message": "Unexpected token \"end of statement block\"..."
    }
]
```

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

### enterNode() Method Signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

The enterNode method signature used for inspecting AST nodes.

```php
public function enterNode(Node $node, Environment $env): Node
```

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

### Facade Caller constructor signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Constructor for the Caller class. Accepts a fully-qualified facade class name and an optional options array merged over defaults.

```php
public function __construct($facade, array $options = [])
```

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

### Facades loader class

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Defines the Facades extension loader that implements GlobalsInterface. It reads the 'twigbridge.extensions.facades' config and creates a Caller for each facade, exposing them as Twig globals. Supports full option syntax including 'is_safe' and 'charset'.

```php
class Facades extends Loader implements GlobalsInterface
{
    public function getName()
    {
        return 'TwigBridge_Extension_Loader_Facades';
    }

    public function getGlobals(): array
    {
        $load    = $this->config->get('twigbridge.extensions.facades', []);
        $globals = [];

        foreach ($load as $facade => $options) {
            list($facade, $callable, $options) = $this->parseCallable($facade, $options);
            $globals[$facade] = new Caller($callable, $options);
        }

        return $globals;
    }
}
```

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

### Render Twig Views

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Call Twig templates using the View::make method, similar to standard Laravel views.

```php
// Without the file extension
View::make('i_am_twig', [...])
```

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

### TwigBridge\Bridge::getApplication

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Returns the Laravel container instance that was passed to the constructor, or null if none was provided.

```APIDOC
## TwigBridge\Bridge::getApplication

### Description
Returns the Laravel container instance that was passed to the constructor, or null if none was provided.

### Method
Getter

### Signature
public function getApplication()

### Parameters
None

### Response
- **Return** (\Illuminate\Contracts\Container\Container|null) - The Laravel container, or null if not set.
```

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

### Call Functions with Parameters

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Invoke functions within Twig templates, passing parameters as needed.

```html
{{ link_to_route('tasks.edit', 'Edit', task.id, {'class': 'btn btn-primary'}) }}
```

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

### Lint result record structure

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/types.md

Each entry in the $details array rendered by Command\Lint::display(). The 'template' key holds Twig\Source objects for file templates or plain strings for STDIN input; 'file' is null for STDIN. The 'exception' key is present only when 'valid' is false.

```php
// valid
['template' => Twig\Source|string, 'file' => string|null, 'valid' => true]

// invalid
['template' => Twig\Source|string, 'file' => string|null, 'valid' => false, 'exception' => Twig\Error\Error]
```

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

### Facade\Caller::__construct($facade, $options)

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Constructor for the Caller proxy object that holds a facade class name and options for Twig\Markup handling.

```APIDOC
## Facade\Caller::__construct($facade, $options)

### Description
Creates a Caller instance that proxies calls to a Laravel facade. Options control whether results are marked as safe HTML and the charset for Twig\Markup.

### Method Signature
`public function __construct($facade, array $options = [])`

### Parameters
- **facade** (string) - Required - Fully-qualified facade class name (e.g., `Illuminate\Support\Facades\Config`).
- **options** (array) - Optional - Merged over defaults `['is_safe' => null, 'charset' => null]`. `is_safe` can be `true` or an array of safe method names; `charset` is passed to `Twig\Markup`.

### Example (PHP)
```php
$caller = new Caller(\Illuminate\Support\Facades\Config::class);
```

### Example (Config)
```php
'facades' => [
    'Config' => Illuminate\Support\Facades\Config::class,
    'Form' => [
        'is_safe' => ['open', 'close'],
    ],
],
```
```

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

### Filters::getFilters()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Creates Twig\TwigFilter instances from the `twigbridge.extensions.filters` configuration. Each filter can be defined as a method-to-callable mapping, optionally with a callback and options.

```APIDOC
## Filters::getFilters()

### Description
Builds an array of `Twig\TwigFilter` objects from the configured `twigbridge.extensions.filters` array. Each filter's callable is wrapped in a closure that uses `call_user_func_array`.

### Method Signature
`getFilters(): array`

### Return Value
- **array** - List of `Twig\TwigFilter` instances.

### Configuration Format
The `twigbridge.extensions.filters` config is an associative array where the key is the filter name and the value is either a callable or an array with `callback` and optionally `options`.

### Example (Config)
```php
'filters' => [
    'snake' => [
        'callback' => 'snake_case',
    ],
    'get' => 'data_get',
],
```

### Example (Twig Usage)
```twig
{{ "Hello World"|snake }}
```

### Notes
- The default config includes `'get' => 'data_get'` (Laravel's `data_get` helper).
```

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

### findTemplate method

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/twig-loader.md

Resolves a template name to its absolute path using the view finder or filesystem.

```php
public function findTemplate($name)
```

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

### TwigBridge\Engine\Twig::__construct

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/engine.md

Constructor for the Twig engine. Initializes the engine with a compiler, loader, and optional global data.

```APIDOC
## TwigBridge\Engine\Twig::__construct

### Description
Initializes the Twig engine with the given compiler, loader, and global data.

### Method
Constructor

### Signature
public function __construct(Compiler $compiler, LoaderInterface $loader, array $globalData = [])

### Parameters
- **$compiler** (TwigBridge\Engine\Compiler) - Required - The Twig compiler.
- **$loader** (Twig\Loader\LoaderInterface) - Required - View finder loader used to locate template files for error messages.
- **$globalData** (array) - Optional - Data passed to all templates; defaults to config('twigbridge.twig.globals', []).
```

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

### Lint Twig templates

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Validates the syntax of all Twig templates in the project.

```bash
$ php artisan twig:lint
```

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

### Configure extensions.filters

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/configuration.md

Defines latent filters for Twig, using the same option contract as functions.

```php
'filters' => [
    'get' => 'data_get',            // {{ user|get('name') }}
    'snake' => [
        'callback' => 'snake_case',
    ],
],
```

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

### getPriority() Method Signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

The getPriority method signature, returning the visitor priority.

```php
public function getPriority()
```

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

### EventNode compile() Implementation

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/nodes.md

The implementation of the compile method that writes the event trigger invocation into the compiled template.

```php
$compiler
    ->write('$context = ' . EventNode::class . '::triggerLaravelEvents($this->getTemplateName(), $context);')
    ->raw("\n");
```

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

### setFinder() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/commands.md

Signature for the setFinder() method, which sets a custom finder instance.

```php
public function setFinder(Finder $finder)
```

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

### Functions loader class implementation

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

The Functions class extends Loader and defines getName returning 'TwigBridge_Extension_Loader_Functions'. getFunctions reads the 'twigbridge.extensions.functions' config, parses each entry, and creates TwigFunction instances that forward arguments via call_user_func_array.

```php
class Functions extends Loader
{
    public function getName()
    {
        return 'TwigBridge_Extension_Loader_Functions';
    }

    public function getFunctions()
    {
        $load      = $this->config->get('twigbridge.extensions.functions', []);
        $functions = [];

        foreach ($load as $method => $callable) {
            list($method, $callable, $options) = $this->parseCallable($method, $callable);

            $function = new TwigFunction(
                $method,
                function () use ($callable) {
                    return call_user_func_array($callable, func_get_args());
                },
                $options
            );

            $functions[] = $function;
        }

        return $functions;
    }
}
```

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

### Register TwigBridge Facade

Source: https://github.com/rcrowe/twigbridge/blob/master/README.md

Add the Twig Facade to the aliases array in config/app.php for easier access.

```php
'Twig' => 'TwigBridge\Facade\Twig',
```

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

### Handling Twig Rendering Errors

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/bridge.md

Shows how to catch RuntimeError exceptions when rendering templates to handle missing templates or other Twig-related failures.

```php
use TwigBridge\Facade\Twig;
use Twig\Error\RuntimeError;

try {
    Twig::render('billing/invoice', ['order' => $order]);
} catch (RuntimeError $e) {
    Log::error('Twig render failed', ['message' => $e->getMessage()]);
}
```

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

### registerLoaders() method signature

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/service-provider.md

The protected method signature for registerLoaders().

```php
protected function registerLoaders()
```

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

### Caller constructor options merge

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/types.md

Merges the provided options over the defaults for a Caller instance. The defaults set 'is_safe' and 'charset' to null, and the merge allows overriding them.

```php
$this->options = array_merge(
    [
        'is_safe' => null,
        'charset' => null,
    ],
    $options
);
```

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

### Facade\Caller::getFacade()

Source: https://github.com/rcrowe/twigbridge/blob/master/_autodocs/api-reference/extension-loader.md

Returns the facade class string configured for this Caller instance.

```APIDOC
## Facade\Caller::getFacade()

### Description
Retrieves the facade class name that was passed to the constructor.

### Method Signature
`public function getFacade(): string`

### Return Value
- **string** - The facade class name.

### Example (PHP)
```php
$facade = $caller->getFacade(); // e.g., 'Illuminate\Support\Facades\Config'
```
```
Tokens:
Raw