This library is a convenient to use implementation of the shopping cart with the following features:
- prices calculation (gross/net)
- tax calculation
- multiple price formats
- shipping costs
- payment costs
- customized discounts
- stock validation
- increasing/decreasing items quantity
Also you do not have to worry about the correctness of operations on the amounts of money, this is carried out with the help of the Money for PHP library which is the implementation of the Money pattern by Martin Fowler.
This package is PSR-2 and PSR-4 compliant.
Via Composer
$ composer require darkorsa/shopA few steps are required to create a cart object.
Products represent the goods sold in the shop. The required parameters are:
- id
- name
- stock (how much of that product is available on stock)
- price
- taxRate
optional params:
- weight
- imagePath
use Plane\Shop\Product;
$someProduct = new Product([
'id' => '1',
'name' => 'Some product',
'stock' => 8,
'price' => 2.8,
'taxRate' => 0.10, // 10%
]);If you need to include additional product data in your shopping cart, you can extend Product functionality by using the decorator pattern.
Cart items represent the content of the shopping cart. Items can be injected into Cart object one by one or with use of collection.
use Plane\Shop\CartItem;
use Plane\Shop\CartItemCollection;
// one by one
$cart->add(new CartItem($someProduct));
// collection
$cartItemCollection = new CartItemCollection();
$cartItemCollection->addItem(new CartItem($someProduct)); // cart item with 1 piece of a product
$cartItemCollection->addItem(new CartItem($someOtherProduct, 4)); // cart item with 4 pieces of a product
$cart->fill($cartItemCollection);To ensure that the amount of products in the cart is not greater than the amount in stock, a validator can be used.
use Plane\Shop\Exception\QuanityException;
use Plane\Shop\Validator\StockQuantityValidator;
try {
$cartItem = new CartItem($someProduct, 10, new StockQuantityValidator));
} catch (QuanityException $e) {
// handle exception
}Validation also takes place when you add an item to the Cart. When the same item is added again (i.e. an item with the same product ID), the item is not added twice, but it's quantity is incremented.
try {
$cart->add($cartItem);
$cart->add($cartItem); // if sum of items exceeds product stock an exception is thrown
} catch (QuanityException $e) {
// handle exception
}Shipping can be defined so the shipping data will be available within the Cart object.
use Plane\Shop\Shipping;
$shipping = new Shipping([
'id' => 1,
'name' => 'National Shipping Company',
'description' => 'Standart Ground Shipping',
'cost' => 7.50,
]);
$cart->setShipping($shipping);Payment can be defined in order to calculate payment fee. There are two methods of fee calculation. Fixed price and percentage.
use Plane\Shop\Payment;
// fixed price
$payment = Payment::createWithFixedFee([
'id' => 1,
'name' => 'PayPal',
'description' => 'Payment with Paypal',
'fee' => 8.45
]);
// percentage of the total gross price after discounts
$payment = Payment::createWithPercentageFee([
'id' => 1,
'name' => 'PayPal',
'description' => 'Payment with Paypal',
'fee' => 2 // 2%
]);
$cart->setPayment($payment);Cart is an object representing a shopping cart and provides all the necessary methods to manage it or obtain calculated data.
use Plane\Shop\Cart;
$cart = new Cart('USD');
$cart->fill($cartItemCollection); // fill cart with many items at once
$cart->add($cartItem); // add single cart itemCurrency must be in ISO standard.
$cart->itemsQuantity(); // total quantity of cart items
$cart->totalNet(); // total net price
$cart->totalGross(); // total gross price
$cart->tax() // sum of taxes for all items;
$cart->weight(); // total items weight
$cart->shippingCost() // shipping cost;
$cart->paymentFee(); // payment fee (percentage or fixed)
$cart->totalAfterDiscounts(); // total gross price after applying all discountsNote that all prices are represented as Money object.
Discount can be applied to the Cart object. This library comes with 2 predefined discounts, however custom discounts can be applied as well.
- TotalPriceThresholdDiscount - the discount will be applied when the total price exceeds a certain price threshold
- EverySecondItemFreeDiscount - every second cart item is free
Discount example:
use Plane\Shop\Discount\TotalPriceThresholdDiscount;
$priceTresholdDiscount = new TotalPriceThresholdDiscount('Discount description', $cart, [
'treshold' => 100,
'discount' => 0.1 // ten percent discount for total gross price above 100
]);
$cart->addDiscount($priceTresholdDiscount); By default the prices are returned as Money object but one can easly format all the prices within Cart with use of CartPresenter.
Default formatter is Decimal Formatter.
use Plane\Shop\CartPresenter;
$cartPresenter = new CartPresenter($cart);
echo $cartPresenter->totalNet(); // 10.00
echo $cartPresenter->totalGross(); // 10.22
echo $cartPresenter->tax(); // 0.22One can use other formatters shipped with Money for PHP library or write own custom formmatter.
use Money\Currencies\ISOCurrencies;
use Money\Formatter\IntlMoneyFormatter;
$numberFormatter = new \NumberFormatter('us_US', \NumberFormatter::CURRENCY);
$moneyFormatter = new IntlMoneyFormatter($numberFormatter, new ISOCurrencies());
$cartPresenter = new CartPresenter($cart, $moneyFormatter);
echo $cartPresenter->totalNet(); // $10.00
echo $cartPresenter->totalGross(); // $10.22
echo $cartPresenter->tax(); // $0.22To obtain all the cart data like prices, items, products, shipping details, payment, etc. toArray method can be used.
This data can then be passed on to the presentation layers or as an API response.
$cartData = $cartPresenter->toArray();If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.