v4
Getting Started
The Basics
Sessions
The HTTP protocol is inherently stateless. If you want to maintain some data between requests, you will need to use the Session.
Configuration
The Session is configured using the
config/session.php file. By default Lumberjack is configured to store all session data as files on the disk.Usage
If you're using the global helpers, you can use the
session() helper function instead of the Session facade. For example:1
$value = session('key', 'default');
Copied!
Retrieving Data
The primary way to work with session data is via the
Session Facade:1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
$value = Session::get('key');
Copied!
You can also pass an optional second parameter to use as a default in the instance the requested key doesn't exist:
1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
$value = Session::get('key', 'default');
Copied!
Retrieving All Session Data
You can use the
all() function if you wish to retrieve all the session data:1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
$data = Session::all();
Copied!
Determine If An Item Exists In The Session
You can check if a specific key is stored in the session using the
has() function:1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
if (Session::has('key')) {
4
// Do something
5
}
Copied!
Retrieve and remove
If you wish to remove an item from the session but also retrieve it's current value, you can use the
pull() function:1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
$value = Session::pull('key');
Copied!
Storing Data
To store data into the session you use the
put() function:1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::put('key', 'value');
Copied!
You can pass in an array of key/value pairs to add multiple items.
1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::put([
4
'key' =>'value',
5
'foo' => 'bar',
6
]);
Copied!
Adding items to an array
If you have an array in your session, you can add new data to it by using the
push() function:1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::push('key', 'value');
4
​
5
Session::all(); // [ 'key' => ['value'] ]
6
​
7
Session::push('key', 'another');
8
​
9
Session::all(); // [ 'key' => ['value', 'another] ]
Copied!
Flash Data
There are times when you only want to keep session data for the next request, e.g. form values when a validation error occurs.
You can achieve this easily in Lumberjack using the
flash() function:1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::flash('key', 'value');
Copied!
You can pass in an array of key/value pairs to flash multiple items.
1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::flash([
4
'key' =>'value',
5
'foo' => 'bar',
6
]);
Copied!
If you later decide that you need the data to persist in the session you can do this in two ways. Use the
keep() to select specific keys to retain or reflash() to store all flash data for an additional request.1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::keep('key');
4
​
5
// or
6
​
7
Session::reflash();
Copied!
Deleting Data
To remove a specific item from the session you use the
forget() method.1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::forget('key');
Copied!
To remove multiple items from the session you can pass an array of keys into the
forget() method.1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::forget(['key1', 'key2']);
Copied!
To remove all items from the session, you can use the
flush() method.1
use Rareloop\Lumberjack\Facades\Session;
2
​
3
Session::flush();
Copied!
Adding Custom Storage Drivers
Lumberjack is capable of using multiple different drivers for session storage. The default and only driver provided in the core is the
file driver, which saves all session data to disk.It is simple to implement and register a new driver though.
Implement the driver
Start by creating a class that implements the standard PHP SessionHandlerInterface that provides the storage functionality you require:
1
namespace App\Session\Drivers;
2
​
3
class DatabaseSessionDriver implements \SessionHandlerInterface
4
{
5
/**
6
* Perform and opening/initialisation required for this driver
7
* Note: In most cases this can be empty
8
*/
9
public function open ($save_path, $session_name) {}
10
​
11
/**
12
* Perform and closing/shutdown required for this driver
13
* Note: In most cases this can be empty
14
*/
15
public function close () {}
16
​
17
/**
18
* Return a string of the data associated with $session_id
19
*/
20
public function read ($session_id) {}
21
​
22
/**
23
* Save the provided string data against $session_id
24
*/
25
public function write ($session_id, $session_data) {}
26
​
27
/**
28
* Remove any data associated with $session_id
29
*/
30
public function destroy ($session_id) {}
31
​
32
/**
33
* Remove all session data that is older than $maxlifetime
34
* Note: $maxlifetime is provided as a Unix timestamp
35
*/
36
public function gc ($maxlifetime) {}
37
}
Copied!
Register the driver
To register the new driver you need to use a Service Provider. If you don't want to create a new provider you can use the
AppServiceProvider which can be found in app\Providers\AppServiceProvider.php.Registration is done by calling
extend() on the Session facade:1
<?php
2
​
3
namespace App\Providers;
4
​
5
use Rareloop\Lumberjack\Facades\Session;
6
use Rareloop\Lumberjack\Providers\ServiceProvider;
7
use App\Session\Drivers\DatabaseSessionDriver;
8
​
9
class AppServiceProvider extends ServiceProvider
10
{
11
/**
12
* Register any app specific items into the container
13
*/
14
public function register()
15
{
16
​
17
}
18
​
19
/**
20
* Perform any additional boot required for this application
21
*/
22
public function boot()
23
{
24
Session::extend('database', function($app) {
25
return new DatabaseSessionDriver;
26
});
27
}
28
}
Copied!
After this it's just a matter of updating the
driver value in config/session.php to match the key you passed to extend(), in this instance this would be database.Last modified 3yr ago