lenius / basket
Shopping basket package
Installs: 21 433
Dependents: 3
Suggesters: 0
Security: 0
Stars: 12
Watchers: 3
Forks: 1
Open Issues: 3
Requires
- php: ^8.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.4
- php-coveralls/php-coveralls: 2.5.2
- phpstan/phpstan: ^1.7
- phpunit/phpunit: ^9.0
- squizlabs/php_codesniffer: 3.6.2
- vimeo/psalm: ^5.0
README
The Lenius shopping basket composer package makes it easy to implement a shopping basket into your application and store the basket data using one of the numerous data stores provided. You can also inject your own data store if you would like your basket data to be stored elsewhere.
Installation
Using composer:
$ composer require lenius/basket:^4.0 (PHP7.4) $ composer require lenius/basket:^5.0 (PHP8.x)
Usage
Below is a basic usage guide for this package.
Instantiating the basket
Before you begin, you will need to know which storage and identifier method you are going to use. The identifier is how you store which basket is for that user. So if you store your basket in the database, then you need a cookie (or some other way of storing an identifier) so we can link the user to a stored basket.
In this example we're going to use the cookie identifier and session for storage.
use Lenius\Basket\Basket; use Lenius\Basket\Storage\Session; use Lenius\Basket\Identifier\Cookie; $basket = new Basket(new Session, new Cookie);
Inserting items into the basket
Inserting an item into the basket is easy. The required keys are id, name, price, weight and quantity, although you can pass over any custom data that you like.
$basket->insert(new Item([ 'id' => 'foo', 'name' => 'bar', 'price' => 100, 'quantity' => 2, 'weight' => 300 ]));
Inserting items with options into the basket
Inserting an item into the basket is easy. The required keys are id, name, price and quantity, although you can pass over any custom data that you like. If option items contains price or weight there values are added to the total weight / price of the product.
$basket->insert(new Item([ 'id' => 'foo', 'name' => 'bar', 'price' => 100, 'quantity' => 2, 'weight' => 300, 'options' => [ [ 'name' => 'Size', 'value' => 'L', 'weight' => 50, 'price' => 10 ], ], ]));
Setting the tax rate for an item
Another key you can pass to your insert method is 'tax'. This is a percentage which you would like to be added onto the price of the item.
In the below example we will use 25% for the tax rate.
$basket->insert(new Item([ 'id' => 'mouseid', 'name' => 'Mouse', 'price' => 100, 'quantity' => 1, 'tax' => 25, 'weight' => 200 ]));
Updating items in the basket
You can update items in your basket by updating any property on a basket item. For example, if you were within a basket loop then you can update a specific item using the below example.
foreach ($basket->contents() as $item) { $item->name = 'Foo'; $item->quantity = 1; }
Destroying/emptying the basket
You can completely empty/destroy the basket by using the destroy()
method.
$basket->destroy()
Retrieve the basket contents
You can loop the basket contents by using the following method
$basket->contents();
You can also return the Basket items as an array by passing true as the first argument
$basket->contents(true);
Retrieving the total items in the Basket
$basket->totalItems();
Retrieving the Basket total
$basket->total();
By default the total()
method will return the total value of the Basket as a float
, this will include
any item taxes. If you want to retrieve the Basket total without tax then you can do so by passing false to the
total()
method
$basket->total(false);
Check if the Basket has an item
$basket->has($itemIdentifier);
Remove an item from the Basket
$basket->remove($identifier)
Retrieve an item object by identifier
$basket->item($itemIdentifier);
Basket items
There are several features of the Basket items that may also help when integrating your Basket.
Check if an item has options
You can check if a Basket item has options by using the hasOptions()
method.
foreach ($basket->contents() as $item) { if ($item->hasOptions()) { // We have options } }
You can also get the total weight for a single item
$item->weight();
Output the item data as an array
$item->toArray();
Testing
Run the tests with:
composer psalm
composer stan
composer test
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security-related issues, please email info@lenius.dk instead of using the issue tracker.
License
The MIT License (MIT). Please see License File for more information.