Helpers

Website Rareloop Timber Documentation Twig Documentation
Search…
Helpers
Introduction
Lumberjack provides a handful of helpful functions that should make your life a little easier.
By default they are available as static methods on the \Rareloop\Lumberjack\Helpers class, so that the global namespace isn't getting polluted. You can safely use these methods without fear of function names clashing.
You can tell Lumberjack to create global functions for you if you do not mind about adding these functions to the global namespace.
If you are building packages or plugins specifically for Lumberjack, you cannot rely on the global helper functions as the theme may not have made them available.
Adding Global Helpers
In order to use the global helper functions, all you need to do it tell composer to autoload vendor/rareloop/lumberjack-core/src/functions.php.
Add the following to your top-level composer.json file:
1
"autoload": {
2
    "files": [
3
        "vendor/rareloop/lumberjack-core/src/functions.php"
4
    ]
5
}
Copied!
Then, tell composer to regenerate its list of autoloaded files by running composer dump-autoload.
Available Helpers
​app​
​config​
​view​
​route​
​redirect​
​session​
​request​
​back​
​report​
​logger​
app
The app helper returns the current reference to the container.
1
$app = \Rareloop\Lumberjack\Helpers::app();
2
​
3
// Global function
4
$app = app();
Copied!
You can resolve objects from the container by passing in the class name or reference into app().
1
$gateway = \Rareloop\Lumberjack\Helpers::app(\App\PaymentGateway::class);
2
​
3
// Global function
4
$gateway = app(\App\PaymentGateway::class);
Copied!
config
The config helper allows you to get values from your config.
1
$value = \Rareloop\Lumberjack\Helpers::config('app.environment');
2
​
3
// Global function
4
$value = config('app.environment');
Copied!
By passing in an array to the config helper you can set config values.
1
\Rareloop\Lumberjack\Helpers::config(['app.logs.enabled' => false]);
2
​
3
// Global function
4
config(['app.logs.enabled' => false]);
Copied!
view
The view helper returns a new Rareloop\Lumberjack\Http\Responses\TimberResponse.
1
return \Rareloop\Lumberjack\Helpers::view('templates/posts.twig', $context, 200, $headers);
2
​
3
// Global function
4
return view('templates/posts.twig', $context, 200, $headers);
Copied!
route
The route helper generates a URL from a named route.
1
$url = \Rareloop\Lumberjack\Helpers::route('posts.index');
2
​
3
// Global function
4
$url = route('posts.index');
Copied!
If the route requires parameters you can be pass an associative array as a second parameter:
1
$url = \Rareloop\Lumberjack\Helpers::route('posts.show', ['id' => 123]);
2
​
3
// Global function
4
$url = route('posts.show', ['id' => 123]);
Copied!
redirect
The redirect helper returns a new Zend\Diactoros\Response\RedirectResponse, which redirects the user to a given URL.
1
$url = \Rareloop\Lumberjack\Helpers::redirect('/auth/login', 200, $headers);
2
​
3
// Global function
4
$url = redirect('/auth/login', 200, $headers);
Copied!
session
You can use the session helper to retrieve and store data in the current session. Passing in 1 (string) argument will get the value of that item from the session. Passing in an array of key/value pairs will add each pair to the session.
1
// Get a value from the session
2
$name = \Rareloop\Lumberjack\Helpers::session('name');
3
​
4
// Get a value from the session, with a default
5
$name = \Rareloop\Lumberjack\Helpers::session('name', 'default');
6
​
7
// Set a value to the session
8
\Rareloop\Lumberjack\Helpers::session(['key' => 'value']);
9
​
10
// Call any method on a session
11
\Rareloop\Lumberjack\Helpers::session()->forget('key');
Copied!
And using the global function instead:
1
// Get a value from the session
2
$name = session('name');
3
​
4
// Get a value from the session, with a default
5
$name = session('name', 'default');
6
​
7
// Store a value to the session
8
session(['key' => 'value']);
9
​
10
// Call any method on a session
11
session()->forget('key');
Copied!
request
The request helper returns the current ServerRequest object, which means you get access to all these available methods.
1
$request = \Rareloop\Lumberjack\Helpers::request();
2
​
3
// Global function
4
$request = request();
Copied!
For example, to get the current url:
1
$currentUrl = request()->url(); // e.g. http://test.com/path
Copied!
HTTP Requests
back
Returns a RedirectResponse, which will redirect the user to the previous URL.
1
return \Rareloop\Lumberjack\Helpers::back();
2
​
3
// Global function
4
return back();
Copied!
If you need to pass any data back to the previous page, you can flash items to the session using with():
1
// Chain 'with' multiple times
2
return \Rareloop\Lumberjack\Helpers::back()
3
    ->with('key', 'value')
4
    ->with('foo', 'bar');
5
​
6
// Or use an array with key/value pairs
7
return \Rareloop\Lumberjack\Helpers::back()->with([
8
    'key' => 'value,
9
    'foo' => 'bar',
10
]);
11
​
12
// Global function
13
return back()
14
    ->with('key', 'value')
15
    ->with('foo', 'bar');
16
​
17
// Or use an array with key/value pairs
18
return back()->with([
19
    'key' => 'value,
20
    'foo' => 'bar',
21
]);
Copied!
report
Calls the report method on the Exception Handler, to ensure that an exception is reported.
1
\Rareloop\Lumberjack\Helpers::report($exception);
2
​
3
// Global function
4
report($exception);
Copied!
This is particularly useful if your theme needs to swallow any exceptions so they do not break the site, but you still wish to have the error logged. For example:
1
try {
2
    // This may throw an exception...
3
    $comment = Comment::add($data);
4
​
5
    return JsonResponse($comment, 200);
6
} catch (Exception $exception) {
7
    // Report the exception
8
    report($exception);
9
​
10
    // Swallow the exception, and instead return a response
11
    return JsonResponse([], 400);
12
}
Copied!
"Swallowing" here simply means that the exception is unable to bubble all the way up to the Exception Handler where it normally gets reported.
logger
Available in v4.3.0 and above
The logger helper can be used to write debug messages to your logs.
1
\Rareloop\Lumberjack\Helpers::logger('Example message');
2
​
3
// Global function
4
logger('Example message');
Copied!
You can also pass in an array of additional data alongside your message.
1
\Rareloop\Lumberjack\Helpers::logger('Product added to basket', ['id' => $product->id]);
2
​
3
// Global function
4
logger('Product added to basket', ['id' => $product->id]);
Copied!
If you need to access the logger class itself, to log different types of errors for example, you can use the logger function with no arguments. This will get you an instance of the PSR3 compliant logger that is bound to the container. By default Lumberjack uses Monolog\Logger.
1
\Rareloop\Lumberjack\Helpers::logger()->warning('Example warning');
2
​
3
// Global function
4
logger()->warning('Example warning');
Copied!