Storage Drivers
The cart supports multiple storage backends via a driver system.
Session (default)
Cart data is stored in the Laravel session. No configuration needed.
Database
Store the cart in a database table for persistence across sessions. The package doesn't ship a migration or model for this - you create both yourself.
1. Create a migration:
$table->string('session_id');
$table->text('items');
$table->text('conditions');
2. Add casts to your model:
protected $guarded = [];
protected $casts = [
'items' => 'array',
'conditions' => 'array',
];
3. Update config/cart.php:
'driver' => 'database',
'storage' => [
'database' => [
'model' => \App\Models\Cart::class,
'id' => 'session_id',
'items' => 'items',
'conditions' => 'conditions',
],
],
Redis
Store the cart in Redis with an optional TTL.
'driver' => 'redis',
'drivers' => [
'redis' => [
'connection' => 'default',
'ttl' => 604800, // 7 days in seconds
],
],
Multi-driver
Write to multiple drivers simultaneously. Reads come from the first driver listed.
'driver' => 'multi',
'drivers' => [
'multi' => ['session', 'database'],
],
Custom driver
Generate a custom driver stub with php artisan cart:make:driver MyDriver, which implements CartDriver in app/Cart/Drivers. Register it with Cart::extend() from a service provider's boot() method:
use Wearepixel\Cart\Cart;
use App\Cart\Drivers\MyDriver;
Cart::extend('my-driver', fn ($sessionKey, $config) => new MyDriver($sessionKey));
Then set it as the active driver:
'driver' => 'my-driver',