Приложение GG Test Yii2

Добавление возможности бесконечного расширения списка атрибутов у хранимых сущностей

Минимальные требования

• PHP 7.0+
• MySQL 5.0+
• Composer

Установка

cd /var/www
git clone https://github.com/pvolyntsev/gg-test-yii2.git
cd gg-test-yii2
composer global require "fxp/composer-asset-plugin:~1.1.4"
composer install

Создание БД

DROP DATABASE IF EXISTS `gg_test_yii2`;
CREATE DATABASE IF NOT EXISTS `gg_test_yii2` DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
GRANT ALL PRIVILEGES ON gg_test_yii2.* TO gg_test_yii2_user@localhost IDENTIFIED BY '123456';

Параметры базы данных можно установить в файле config/db.php

return [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=gg_test_yii2',
    'username' => 'gg_test_yii2_user',
    'password' => '123456',
    'charset' => 'utf8',
];

Загрузка моделей и начальных данных в СУБД

cd /var/www/gg-test-yii2
php yii migrate/up

Тесты

Реализованы только модульные тесты

vendor/bin/codecept run unit

Codeception PHP Testing Framework v2.3.5
Powered by PHPUnit 6.2.4 by Sebastian Bergmann and contributors.

Unit Tests (7) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
✔ PageEAVTes: Page by id (0.51s)
✔ PageEAVTes: Read extra attribute (0.11s)
✔ PageEAVTes: Write extra attribute (0.05s)
✔ PageEAVTes: Save extra attributes (0.25s)
✔ PageEAVTes: Remove extra attribute (0.09s)
✔ PageEAVTes: New entity with attributes (0.11s)
✔ PageEAVTes: Remove attributes when delete entity (0.09s)
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------


Time: 5.18 seconds, Memory: 14.00MB

OK (7 tests, 30 assertions)

Использование

Используется только для хранимых классов, которые наследуюются от ActiveRecord.

Для включения такой возможности необходимо указать базовый класс \app\library\eav\BaseActiveRecord

Пример подключения:

CREATE TABLE `shop_item` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(255) NOT NULL,
  PRIMARY KEY (`id`),
) ENGINE=InnoDB DEFAULT CHARSET=utf8

<?php

class ShopItem extends \app\library\eav\BaseActiveRecord
{
    public static function tableName()
    {
        return 'shop_item';
    }

    public function rules()
    {
        return [
            [['name'], 'required'],
            [['name' => 255],
        ];
    }

    public function attributeLabels()
    {
        return [
            'id' => 'ID',
            'name' => 'Name',
        ];
    }
}

Пример использования

<?php

$shopItem = new ShopItem; // или ShopItem::findOne(<id>)
$shopItem->name = 'Car'; // обращение к свойству name, хранящемуся в таблице `shop_item`
$shopItem->color = 'red'; // обращение к дополнительному свойству
unset($shopItem->color); // удаление дополнительного свойства

TODO

• оформить как подключаемую компоненту
• реализовать через Traits
• реализовать разные типы данных для дополнительных атрибутов (сейчас только строки до 255 символов)
• реализовать сложные типы данных для дополнительных атрибутов (хотелось бы хранить массивы)
• добавить пример SQL для поиска записей по его атрибутам
• (minor) при смене ID сущности обновлять атрибуты
• добавить возможность работать с первичными ключами-строками (сейчас первичный ключ может быть только unsigned int(11))
• (minor) добавить возможность работать с составными первичными ключами (сейчас только простой ключ)