library cart

agoalofalife/cart

Cart

, _(*1)

Что это такое?, _(*2)

Это простой пакет для хранение товаров в корзине магазина. Он не навязывает свою структуру и вы всегда сможете поменять тип хранения, давай рассмотрим его уже!, _(*3)

• Требования
• Установка
• Установка конфигураций
• Драйвера
  • Использование
• Написание своего драйвера
• Интеграция с Laravel
• Простое использование

, _(*4)

Обратите внимание, что для использования необходимо иметь :
- Mysql не ниже версии 5.7.8 (Если вы используете драйвер по-умолчанию)
- Версия PHP не ниже 7.1

Установка, _(*5)

Достаточно выполнить, _(*6)

composer require agoalofalife/cart

Установка конфигураций, _(*7)

В начале было слово..., _(*8)

Каждый раз когда вы создаете класс для корзины, он может иметь свой способ хранения информации (Драйвера)., _(*9)

Например , драйвер базы данных имеет настройки подключения, название таблицы и тому подобное. Давайте рассмотрим как мы можем загрузить конфигурации:, _(*10)

$kernel = new \Cart\Kernel();
$kernel->bootstrapping();
$kernel->loadConfiguration(new \Cart\SourcesConfigurations\File(__DIR__ . '/config/cart.php'));

Метод loadConfiguration принимает обьект типа SourceConfiguration, вы можете использовать класс File по умолчанию передав в конструктор путь до файла, или написать свой класс , реализующий SourceConfiguration., _(*11)

   // Сервис - провайдеры для настройки ваших драйверов
    'services' => [
        Cart\ServiceProviders\DatabaseServiceProviders::class,
        \Cart\ServiceProviders\RedisServiceProvider::class,
    ],
    'drivers' => [
    // конфигурации в зависимости от драйвера
        'database' => [
            'driver'    => 'mysql',
            'host'      => 'localhost',
            'database'  => 'test',
            'username'  => 'test',
            'password'  => 'test',
            'charset'   => 'utf8',
            'collation' => 'utf8_unicode_ci',
            'prefix'    => ''
        ],
        'redis' => [
            'prefix' => 'cart',
            'scheme' => 'tcp',
            'host'   => '127.0.0.1',
            'port'   => 6379,
        ]
    ],
    // выбранный текущий драйвер
    'storage' => \Cart\Drivers\DatabaseDriver::class

Сверху показан пример структуры конфигурации. storage и services являются обязательными полями, drivers зависит от настройки вашего драйвера. На данном этапе вы можете скопировать этот пример и внести свои настройки., _(*12)

Драйвера, _(*13)

На данный момент поддерживается два типа драйвера : Redis и база данных., _(*14)

Использование, _(*15)

Какой драйвер вы будете использовать зависит от настройки в файле конфигурации:, _(*16)

    'storage' => \Cart\Drivers\DatabaseDriver::class

Теперь клиентский код:, _(*17)

$kernel = new \Cart\Kernel();
$kernel->bootstrapping();
$kernel->loadConfiguration((new \Cart\SourcesConfigurations\File(__DIR__ . '/config/cart.php')));
$kernel->loadServiceProvider();
// получение драйвера
$storage = $kernel->getStorage();

После того как драйвер получен мы можем добавлять товар в корзину, удалять его, менять кол -во и очищать корзину полностью., _(*18)

// Добавление товара в корзину
// id и user_id обязательные поля, так как это индексы по которым происходят другие операции
// вы в праве добавить больше данных..
$storage->add(['id' => 3, 'user_id' => 1]);

// очистить корзину передав user_id
$storage->clear(1);

// изменить кол -во 
$storage->change(['id' => 5, 'user_id' => 1, 'count' => 0])

// удалить конкретный товар из корзины 
$storage->remove(['id' => 2, 'user_id' => 1]);

// Получить список всех товаров по user_id
$storage->get(1);

Помимо этого так же есть возможность изменить цену товара (Например скидка)., _(*19)

// Поле price обязательно.
// Сделать фиксированную скидку
$storage->discount(new \Cart\DiscountStrategy\FixDiscountStrategy(100), ['id' => 3, 'user_id' => 1, 'price' => 200]);

// Осуществить скидку по проценту
$storage->discount(new \Cart\DiscountStrategy\PercentageStrategy(20), ['id' => 3, 'user_id' => 1, 'price' => 200]);

По желанию вы можете дополнить свою стратегию изменения цены, реализовав интерфейс DiscountContract., _(*20)

Написание своего драйвера, _(*21)

Написать драйвер в три простых шага :, _(*22)

• По примеру создать свой ServiceProvider для начальных конфигураций и дописать его в файле конфигурации.

    'services' => [
        Cart\ServiceProviders\DatabaseServiceProviders::class,
        \Cart\ServiceProviders\RedisServiceProvider::class,
        ...
    ]

• Реализовать интерфейс CartDriverContract и для скидки DiscountDriverContract, _(*23)

• Вставить дравер в файл конфигурации :, _(*24)

  'storage' => \Cart\Drivers\DatabaseDriver::class

Интеграция с Laravel, _(*25)

Для того чтобы интегрировать библиотеку в Laravel необходимо :, _(*26)

• Установить через composer, _(*27)

• Выполнить команду :, _(*28)

./vendor/bin/cart migrate:laravel   

Тем самым скопировать файл конфигурации и миграцию в исходные папки Laravel, _(*29)

• Получить driver из контейнера и работать с ним (Предварительно установив все настройки и выполнив миграцию , если используется драйвер базы данных.)

app('cart')-> ...

Простое использование, _(*30)

• Установить пакет

composer require agoalofalife/cart, _(*31)

• Установить свои настройки базы данных

  'drivers' => [
        'database' => [
            'driver'    => 'mysql',
            'host'      => 'localhost',
            'database'  => 'test',
            'username'  => 'test',
            'password'  => 'test',
            'charset'   => 'utf8',
            'collation' => 'utf8_unicode_ci',
            'prefix'    => ''
        ]

• Выполнить команду для создание таблицы ./vendor/bin/cart cart:migrate, _(*32)

• Начать использовать драйвер базы данных., _(*33)

$kernel = new \Cart\Kernel();
$kernel->bootstrapping();
$kernel->loadConfiguration((new \Cart\SourcesConfigurations\File(__DIR__ . '/cart.php')));
$kernel->loadServiceProvider();
$storage = $kernel->getStorage();