all ready for v2.0.1

Author: Smoren

README.md

@@ -0,0 +1,37 @@
+<?php
+
+
+namespace app\commands;
+
+
+use Smoren\Yii2\QueryRelationManager\Base\QueryRelationManagerException;
+use Smoren\Yii2\QueryRelationManager\Pdo\QueryRelationManager;
+use Smoren\Yii2\QueryRelationManager\Pdo\QueryWrapper;
+use Yii;
+use yii\console\Controller;
+
+/**
+ * Контроллер для демонстрации работы QueryRelationManager с PDO вместо ORM
+ * @package app\commands
+ * @author Smoren <ofigate@gmail.com>
+ */
+class PdoController extends Controller
+{
+    /**
+     * Выбираем адреса с городом, местами и комментариями о местах
+     * Используем PDO вместо ORM
+     * @throws QueryRelationManagerException
+     */
+    public function actionAddress()
+    {
+        QueryWrapper::setDbConfig(Yii::$app->db->dsn, Yii::$app->db->username, Yii::$app->db->password);
+
+        $result = QueryRelationManager::select('address', 'a')
+            ->withSingle('city', 'city', 'c', 'a', ['id' => 'city_id'])
+            ->withMultiple('places', 'place', 'p', 'a', ['address_id' => 'id'])
+            ->withMultiple('comments', 'comment', 'cm', 'p', ['place_id' => 'id'])
+            ->all();
+
+        print_r($result);
+    }
+}

commands/NewController.php

@@ -12,22 +12,24 @@
 use app\models\Comment;
 use app\models\Place;
 use app\helpers\ProfilerHelper;
-use app\qrm\ActiveRecord\QueryRelationDataProvider;
-use app\qrm\ActiveRecord\QueryRelationManager;
-use app\qrm\Base\QueryRelationManagerException;
+use Smoren\Yii2\QueryRelationManager\ActiveRecord\QueryRelationDataProvider;
+use Smoren\Yii2\QueryRelationManager\ActiveRecord\QueryRelationManager;
+use Smoren\Yii2\QueryRelationManager\Base\QueryRelationManagerException;
 use Yii;
 use yii\console\Controller;
 use yii\data\ActiveDataProvider;
 use yii\db\Exception;
 
 /**
- * Контроллер для демонстрации работы QueryRelationManager
+ * Контроллер для профилирования QueryRelationManager
+ * @package app\commands
  * @author Smoren <ofigate@gmail.com>
  */
 class ProfileController extends Controller
 {
     /**
      * Выбираем адреса с городом, местами и комментариями о местах
+     * Сравниваем скорость работы ActiveQuery::joinWith и QueryRelationManager
      * @throws QueryRelationManagerException
      * @throws Exception
      */
@@ -56,7 +58,8 @@ public function actionAddress()
     }
 
     /**
-     * Выбираем адреса с городом, местами и комментариями о местах
+     * Выбираем адреса с городом, местами и комментариями о местах, используем DataProvider для постраничной навигации
+     * Сравниваем скорость работы ActiveQuery::joinWith и QueryRelationManager
      * @throws QueryRelationManagerException
      * @throws Exception
      */
@@ -127,6 +130,7 @@ public function actionProvider()
     }
 
     /**
+     * Генерирует миллион адресов
      * @throws Exception
      */
     protected function genAddresses()
@@ -143,6 +147,7 @@ protected function genAddresses()
     }
 
     /**
+     * Удаляет сгенерированные адреса
      * @throws Exception
      */
     protected function delAddresses()
@@ -153,10 +158,11 @@ protected function delAddresses()
     }
 
     /**
-     * @param string $who
-     * @param float $time
-     * @param int $foundCount
-     * @param int|null $totalCount
+     * Выводит данные профилирования в консоль
+     * @param string $who предмет замера
+     * @param float $time время работы
+     * @param int|null $foundCount найдено записей
+     * @param int|null $totalCount запрошено записей
      */
     protected function log(string $who, float $time, ?int $foundCount = null, ?int $totalCount = null)
     {

commands/PdoController.php

@@ -0,0 +1,42 @@
+<?php
+
+
+namespace app\commands;
+
+
+use app\models\Address;
+use app\models\City;
+use Smoren\Yii2\QueryRelationManager\ActiveRecord\QueryRelationDataProvider;
+use Smoren\Yii2\QueryRelationManager\ActiveRecord\QueryRelationManager;
+use Smoren\Yii2\QueryRelationManager\Base\QueryRelationManagerException;
+use Yii;
+use yii\console\Controller;
+
+/**
+ * Контроллер для демонстрации работы QueryRelationManager с использованием DataProvider
+ * @package app\commands
+ * @author Smoren <ofigate@gmail.com>
+ */
+class ProviderController extends Controller
+{
+    /**
+     * Выбираем города с адресами, используем DataProvider для постраничной навигации
+     * @throws QueryRelationManagerException
+     */
+    public function actionCity()
+    {
+        $qrm = QueryRelationManager::select(City::class, 'c')
+            ->withMultiple('addresses', Address::class, 'a', 'c', ['city_id' => 'id']);
+
+        $dataProvider = new QueryRelationDataProvider([
+            'queryRelationManager' => $qrm,
+            'db' => Yii::$app->db,
+            'pagination' => [
+                'pageSize' => 2,
+                'page' => 0,
+            ],
+        ]);
+
+        print_r($dataProvider->getModels());
+    }
+}