https://github.com/inklabs/kommerce-core
PHP shopping cart core platform
https://github.com/inklabs/kommerce-core
clean-code ddd ecommerce oop php shopping-cart solid tdd
Last synced: 30 days ago
JSON representation
PHP shopping cart core platform
- Host: GitHub
- URL: https://github.com/inklabs/kommerce-core
- Owner: inklabs
- License: apache-2.0
- Created: 2014-12-04T09:13:08.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2018-09-06T03:46:43.000Z (over 7 years ago)
- Last Synced: 2025-02-17T10:49:50.445Z (11 months ago)
- Topics: clean-code, ddd, ecommerce, oop, php, shopping-cart, solid, tdd
- Language: PHP
- Homepage: https://kommerce-laravel-demo.jamieisaacs.com/
- Size: 3.46 MB
- Stars: 65
- Watchers: 5
- Forks: 14
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Zen Kommerce Core
=================
[](https://codeclimate.com/github/inklabs/kommerce-core)
[](https://travis-ci.org/inklabs/kommerce-core)
[](https://packagist.org/packages/inklabs/kommerce-core)
[](https://github.com/inklabs/kommerce-core/blob/master/LICENSE.txt)
## Introduction
Zen Kommerce is a PHP shopping cart system written with SOLID design principles.
It is PSR compatible, dependency free, and contains 100% code coverage using TDD practices.
All code (including tests) conform to the PSR-2 coding standards. The namespace and autoloader
are using the PSR-4 standard.
## Description
This project is over 62,000 lines of code. Unit tests account for 30-40% of that total and execute in
under 10 seconds. The repository tests use an in-memory SQLite database.
## Design Patterns
* [Design Patterns used in this project](docs/DesignPatterns).
## Architecture
* Action
- Command and Queries are the Use Cases and main entry-point into the application.
- **Command Actions** are dispatched to the
[CommandBusInterface](src/Lib/Command/CommandBusInterface.php) to be handled.
```php
$applyToShipping = true;
$command = new CreateStateTaxRateCommand('CA', 9.5, $applyToShipping);
$this->dispatch($command);
```
- There is no return value from the `$this->dispatch(...)` method. Only exceptions are thrown if the
Command is invalid.
- **Query Actions** are dispatched to the
[QueryBusInterface](src/Lib/Query/QueryBusInterface.php) to be handled.
Instead of returning the [Product](src/Entity/Product.php) entity, the handler will inject a
[ProductDTOBuilder](src/EntityDTO/Builder/ProductDTOBuilder.php) object into the Response. The DTO Builder
is used to produce a [ProductDTO](src/EntityDTO/ProductDTO.php) which can be retrieved using the
`$response->getProductDTO()` method.
```php
$productId = '15dc6044-910c-431a-a578-430759ef5dcf';
$query = new GetProductQuery($productId);
/** @var GetProductResponse $response */
$response = $this->dispatchQuery($query);
$productDTO = $response->getProductDTO();
var_export($productDTO);
```
```php
inklabs\kommerce\EntityDTO\ProductDTO::__set_state([
'slug' => 'test-product',
'sku' => '5b6541751fd10',
'name' => 'Test Product',
'unitPrice' => 1200,
'quantity' => 10,
'isInventoryRequired' => false,
'isPriceVisible' => true,
'isActive' => true,
'isVisible' => true,
'isTaxable' => true,
'isShippable' => true,
'isInStock' => true,
'areAttachmentsEnabled' => false,
'shippingWeight' => 16,
'description' => null,
'rating' => null,
'tags' => [],
'images' => [],
'tagImages' => [],
'options' => [],
'textOptions' => [],
'productQuantityDiscounts' => [],
'optionProducts' => [],
'productAttributes' => [],
'price' => inklabs\kommerce\EntityDTO\PriceDTO::__set_state([
'origUnitPrice' => 1200,
'unitPrice' => 1200,
'origQuantityPrice' => 1200,
'quantityPrice' => 1200,
'catalogPromotions' => [],
'productQuantityDiscounts' => []
]),
'id' => inklabs\kommerce\Lib\UUID::fromString('15dc6044-910c-431a-a578-430759ef5dcf'),
'created' => DateTime::__set_state([
'date' => '2018-08-04 06:04:26.000000',
'timezone_type' => 3,
'timezone' => 'UTC',
]),
'updated' => null,
'createdFormatted' => 'August 3, 2018 11:04 pm PDT',
'updatedFormatted' => null,
]);
```
HTML Template:
```html
Product: =$productDTO->name?> - =$productDTO->sku?>
Price: =$productDTO->price->unitPrice?>
Tag: =$productDTO->tags[0]->name?>
```
- Both implementations ([CommandBus](src/Lib/Command/CommandBus.php) and [QueryBus](src/Lib/Query/QueryBus.php))
defer to the [MapperInterface](src/Lib/MapperInterface.php) to determine the location of the
class to handle the execution.
- This CQRS strategy allows us to separate Commands from Queries while also keeping the [Entity](src/Entity)
business objects separate from the main application. We prefer not to expose internal classes containing
methods with business logic. This also serves to decouple the main application from the Use Cases handler
implementation. The main application only needs to know about the Use Case [Actions](src/Action).
* Domain Event
- Domain Events can be raised in the Entity layer and are dispatched in the service layer.
```php
// UserEntity:
public function setPassword($password)
{
$this->passwordHash = // hash the password...
$this->raise(
new PasswordChangedEvent(
$this->id,
$this->email,
$this->getFullName()
)
);
}
```
```php
// UserService:
$user = $this->userRepository->findOneById($userId);
$user->setPassword($password);
$this->userRepository->update($user);
$this->eventDispatcher->dispatch($user->releaseEvents());
```
- Events can be dispatched directly in the service layer. (deprecated)
```php
// CartService:
$order = Order::fromCart($cart);
$this->orderRepository->create($order);
$this->eventDispatcher->dispatchEvent(
new OrderCreatedFromCartEvent($order->getId())
);
```
* Service
- These are the domain services to manage persisting domain state to the database through repositories. They contain
behavior related to multiple Entities and any business logic that does not fit any specific Entity or single Use Case.
* Entity
- These are plain old PHP objects. You will not find any ORM code or external dependencies here. This is where
the relationships between objects are constructed. An Entity contains business logic and behavior with high cohesion to
its own properties. Business logic related to the data of a single instance of an Entity belongs here.
```php
$tag = new Entity\Tag
$tag->setName('Test Tag');
$product = new Entity\Product;
$product->setName('Test Product');
$product->setUnitPrice(500);
$product->setQuantity(1);
$product->setIsInventoryRequired(true);
$product->addTag($tag);
if ($product->inStock()) {
// Show add to cart button
}
```
* EntityRepository
- This module is responsible for storing and retrieving entities. Doctrine 2 is used in this layer to hydrate Entities
using the Data Mapper Pattern.
```php
$productRepository = $this->entityManager->getRepository(Product::class);
$productId = 1;
$product = $productRepository->findOneById($productId);
$product->setUnitPrice(600);
$productRepository->persist($product);
```
* EntityDTO
- These classes are simple anemic objects with no business logic. Data is accessible via public class member variables.
Using the EntityDTOBuilder, the complete network graph relationships are available (e.g., withAllData()) prior to
calling build(). The primary reason for using these Data Transfer Objects (DTO) is to flatten the object graph from
lazy loaded Doctrine proxy objects on the Entities for use in view templates. This avoids lazy loaded queries from
being executed outside the core application and somewhere they don't belong, such as in a view template.
```php
$product = new Entity\Product;
$product->addTag(new Entity\Tag);
$productDTO = $product->getDTOBuilder()
->withAllData(new Lib\Pricing)
->build();
echo $productDTO->sku;
echo $productDTO->price->unitPrice;
echo $productDTO->tags[0]->name;
```
* Lib
- This is where you will find a variety of utility code including the Payment Gateway (src/Lib/PaymentGateway).
```php
$creditCard = new Entity\CreditCard;
$creditCard->setName('John Doe');
$creditCard->setZip5('90210');
$creditCard->setNumber('4242424242424242');
$creditCard->setCvc('123');
$creditCard->setExpirationMonth('1');
$creditCard->setExpirationYear('2020');
$chargeRequest = new Lib\PaymentGateway\ChargeRequest;
$chargeRequest->setCreditCard($creditCard);
$chargeRequest->setAmount(2000);
$chargeRequest->setCurrency('usd');
$chargeRequest->setDescription('test@example.com');
$stripe = new Lib\PaymentGateway\StripeFake;
$charge = $stripe->getCharge($chargeRequest);
```
## Installation
Add the following lines to your ``composer.json`` file.
```JSON
{
"require": {
"inklabs/kommerce-core": "dev-master"
}
}
```
```
composer install
```
## Unit Tests:
vendor/bin/phpunit
### With Code Coverage:
vendor/bin/phpunit --coverage-text --coverage-html coverage_report
## Run Coding Standards Test:
vendor/bin/phpcs -p --standard=PSR2 src/ tests/
## Count Lines of Code:
vendor/bin/phploc src/ tests/ --names="*.php,*.xml"
## Export SQL
vendor/bin/doctrine orm:schema-tool:create --dump-sql
vendor/bin/doctrine orm:schema-tool:update --dump-sql
## License
```
Copyright 2014 Jamie Isaacs pdt256@gmail.com
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```