Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия		 Предыдущая версия
yii2:docs [2017/01/04 22:24] – [Виджеты / Widgets] mirocowyii2:docs [2019/04/18 13:17] (текущий) – [Active Record] mirocow
Строка 290: Строка 290:
       });       });
 </code> </code>
 +
 +==== Form ====
 +
 +  * [[yii2:form|ActiveForm]]
 +  * [[yii2:form|HTML]]   
 +
 +**Подробно** https://github.com/yiisoft/yii2/blob/master/docs/guide/form.md
  
 ===== Ajax ===== ===== Ajax =====
Строка 352: Строка 359:
   * [[yii2:widgets:masked-input|]] - http://demos.krajee.com/masked-input   * [[yii2:widgets:masked-input|]] - http://demos.krajee.com/masked-input
  
-===== Model =====+===== Model / AR / DAO / Запросы к БД =====
  
 Как получить модель из модуля Как получить модель из модуля
Строка 360: Строка 367:
         $profile = Yii::$app->getModule("user")->model("Profile");         $profile = Yii::$app->getModule("user")->model("Profile");
 </code> </code>
 +
 +==== Active Record ====
 +
 +<code php>
 +class Post extends ActiveRecord
 +{
 +    public function getCreator()
 +    {
 +        return $this->hasOne('User', ['id' => 'user_id']);
 +    }
 +    public function getComments()
 +    {
 +        return $this->hasMany('Comment', ['post_id' => 'id']);
 +    }
 +    public function getTrustComments($isTrust = true)
 +    {
 +        return $this->hasMany('Comment', ['post_id' => 'id'])
 +            ->where('status = :status', [
 +                     ':status' => $isTrust ? self::TRUST : self::UNTRUST,
 +              ])
 +            ->orderBy('id');
 +    }
 +}
 +</code>
 +
 +<code php>
 +        $price = PriceItem::find()
 +            ->select(['price', 'create_time' => 'DATE_FORMAT(create_time, "%d.%m.%Y")'])
 +            ->where(['and', 
 +                ['price_list_form_id' => $price_list_form_ids], 
 +                ['>', 'create_time', '2015.01.01']
 +        ])->orderBy(['price' => SORT_ASC])->asArray()->one();
 +</code>
 +
 +<code php>
 +// we receive an ActiveQuery instance
 +$query = Post::find();
 + 
 +// all posts
 +$posts = $query->all();
 + 
 +// looking for all the posts with a condition
 +$posts = $query
 +    ->where(array('status' => Post::DRAFT))
 +    ->orderBy('time')
 +    ->all();
 + 
 +// looking for a post 
 +$post = $query
 +   ->where(['id' => 10, 'status' => Post::READ])
 +   ->one();
 + 
 +// or easier: "where" condition can be transmitted directly to the factory method
 +$post = Post::find(['id' => 10, 'status' => Post::READ]);
 + 
 +// having transmitted to the factory method not a massive, but a number equivalent to the primary key search 
 +$post = Post::find(10)
 +   ->where(['status' => Post::READ])
 +   ->one();
 + 
 +// we index the result to a necessary attribute
 +$posts = $query->indexBy('title')->all();
 + 
 +// the result as an array
 +$posts = $query->asArray()->all();
 +</code>
 +
 +<code php>
 +User::find()->where(['and', ['phone_number' => $phone], ['<>', 'id', $user->id] ])->exists();
 +User::find()->where(['or', ['phone_number' => $phone], ['=', 'id', $user->id] ])->exists();
 +</code>
 +
 +=== Ключи в эллементах коллекции AR ===
 +
 +<code php>
 +$query = SparesCategory::find()->where(['parent_id' => 0]);
 +$query->indexBy = function($row){ // Ключ в который будет помещена возвращаемая модель
 +    return $row->id;
 +};
 +$categories = $query->all();
 +</code>
 +
 +<code php>
 +        $quey = CarMark::find()->indexBy(function($row){
 +            return $row->id;
 +        })->all();
 +</code>
 +
 +=== Создание модели из возвращаемы данных Command (с помощью populateRecord()) ===
 +
 +<code php>
 +        $sql = "SELECT * FROM `tbl_spares_category` c
 +            LEFT JOIN tbl_form_spares_category fc ON fc.category_id = c.id
 +            WHERE fc.form_id = :form_id AND fc.category_id = :category_id";
 +        $select_marks = Yii::$app->db->createCommand($sql, [
 +            ':form_id' => $form_id,
 +            ':category_id' => $category_id,
 +        ])->queryAll();
 +  
 +        foreach($marks as $row){
 +            
 +            // Only yii2 alpha
 +            //$mark = SparesCategoryForm::create($row);
 +          
 +            $mark = new SparesCategoryForm;
 +            SparesCategoryForm::populateRecord($mark, $row);
 +            
 +  
 +            if(isset($mark->id)){
 +  
 +              // do somethig
 +  
 +            }
 +        }
 +</code>
 +
 +  * [[Activedataprovider|Activedataprovider]]
 +  * [[SqlDataProvider|SqlDataProvider]]
 +  * [[ArrayDataProvider|ArrayDataProvider]]
 +==== Join ====
 +
 +=== with() ===
 +
 +Не делает SQL JOIN(), применяется не только в реляционых БД (NoSql)
 +Применяется только для построений конструкций вида **WHERE IN()**, плюс наполняют [[yii2:start#relation|relation]]
 +
 +=== leftJoin() ===
 +
 +Добавляет SQL LEFT JOIN(), применяется только в реляционыых БД, плюс наполняют [[yii2:start#relation|relation]]
 +
 +<code php>
 +$this->joinWith([[relation_name]], true, 'LEFT JOIN')
 +</code>
 +
 +=== joinWith() ===
 +
 +Добавляет SQL JOIN(), применяется только в реляционыых БД, плюс наполняют [[yii2:start#relation|relation]]
 +
 +<code php>
 +// Выбираем MyModel с relation1 и relation2.
 +// Все три забираем запросом с JOIN.
 +$query = MyModel::find()
 +    ->joinWith(['relation1', 'relation2']);
 + 
 +$countQuery = clone $query;
 +$pages = new Pagination(['totalCount' => $countQuery->count(), 'pageSize' => 15]);
 + 
 +$items = $query
 +    ->orderBy($sort->orders)
 +    ->offset($pages->offset)
 +    ->limit($pages->limit)
 +    // Забираем дополнительно relation3 и relation4.
 +    // Фильтровать по ним нам не нужно, так что будут
 +    // запросы вида WHERE ID IN (1,2,3,4) или аналоги
 +    // для noSQL.
 +    ->with(['relation3', 'relation4'])
 +    ->all();
 +</code>
 +
 +https://github.com/yiisoft/yii2/blob/master/docs/guide/active-record.md#joining-with-relations
 +
 +=== innerJoinWith() ===
 +
 +==== Validate (Rules) ====
 +
 +<code php>
 +class User extends \yii\db\ActiveRecord
 +{
 +    // ...
 + 
 +    public function rule()
 +    {
 +        return [
 +                  [
 +                    ['attribute1', 'attribute2', ...],
 +                    'validator class or alias',
 +                    // specifies in which scenario(s) this rule is active.
 +                    // if not given, it means it is active in all scenarios
 +                    'on' => ['scenario1', 'scenario2', ...],
 +                    // the following name-value pairs will be used
 +                    // to initialize the validator properties
 +                    'property1' => 'value1',
 +                    'property2' => 'value2',
 +                    // ...
 +                  ],
 +                  [
 +                    ['attribute1', 'attribute2', ...],
 +                    'validator class or alias',
 +                    // specifies in which scenario(s) this rule is active.
 +                    // if not given, it means it is active in all scenarios
 +                    'except' => ['scenario1', 'scenario2', ...],
 +                    // the following name-value pairs will be used
 +                    // to initialize the validator properties
 +                    'property1' => 'value1',
 +                    'property2' => 'value2',
 +                    // ...
 +                  ],          
 +              ];
 +    }
 + 
 +}
 +</code>
 +
 +Пример использования в модели
 +<code php>
 +  if ($User->load($_POST)) {
 +
 +      $User = new User;
 +      $Profile = new Profile;
 +
 +      // validate for ajax request
 +      $Profile->load($_POST);
 +      if (Yii::$app->request->isAjax) {
 +          Yii::$app->response->format = Response::FORMAT_JSON;
 +          return ActiveForm::validate($User, $Profile);
 +      }
 +
 +      // validate for normal request
 +      if ($User->validate() and $Profile->validate()) {
 +        // do somthing
 +      }
 +  }
 +</code>
 +
 +Пример применения валидатора без использования модели
 +<code php>
 +$email = 'test@example.com';
 +$validator = new yii\validators\EmailValidator();
 +if ($validator->validate($email, $error)) {
 +    echo 'Email is valid.';
 +} else {
 +    echo $error;
 +}
 +</code>
 +
 +  * **Подробно** https://github.com/yiisoft/yii2/blob/master/docs/guide/model.md
 +  * **Список базовых валидаторов:** https://github.com/yiisoft/yii2/blob/master/docs/guide/validation.md
 +
 +==== Scenario ====
 +
 +<code php>
 +class User extends \yii\db\ActiveRecord
 +{
 +    // ...
 +
 +    public function getProduct()
 +    {
 +        return $this->hasOne(Order::className(), ['product_id' => 'id']);
 +    }
 +
 +    public function scenarios()
 +    {
 +        return [
 +            'userCreates' => [
 +                'attributes' => ['name', 'value'],
 +                'atomic' => [self::OP_INSERT],
 +            ],
 +        ];
 +    }
 +  
 +    public function afterSave($insert)
 +    {
 +        parent::afterSave($insert);
 +        if ($this->getScenario() ==== 'userCreates') {
 +            // FIXME: TODO: WIP, TBD
 +        }
 +    }
 +}
 +</code>
 +
 +**Подробно** https://github.com/yiisoft/yii2/blob/master/docs/guide/structure-models.md#scenarios-
 +
 +==== Relation ====
 +
 +<code php>
 +class Customer extends \yii\db\ActiveRecord
 +{
 +    //
 +    public function getOrders()
 +    {
 +        return $this->hasMany(Order::className(), ['customer_id' => 'id']);
 +    }    
 +  
 +    //
 +    public function getBigOrders($threshold = 100)
 +    {
 +        return $this->hasMany(Order::className(), ['customer_id' => 'id'])
 +            ->where('subtotal > :threshold', [':threshold' => $threshold])
 +            ->orderBy('id');
 +    }
 +
 +    // Вытащить данные из таблицы модели Item, используя связи из таблицы tbl_order_item
 +    public function getItems()
 +    {
 +      // Получить данные через таблицу tbl_order_item
 +      return $this->hasMany(Item::className(), ['id' => 'item_id'])
 +            ->viaTable('tbl_order_item', ['order_id' => 'id']);
 +    }
 +    
 +    //
 +    public static function olderThan($query, $age = 30)
 +    {
 +        $query->andWhere('age > :age', [':age' => $age]);
 +    }
 +}
 +</code>
 +
 +<code php>
 +$customer = Customer::find(1);
 +$orders = $customer->orders;
 +$orders = $customer->getBigOrders(200)->all();
 +$customers = Customer::find()->olderThan(50)->all();
 +</code>
 +
 +<code php>
 +$customer = Customer::find(1);
 +$order = new Order();
 +$order->comment = '';
 +$customer->link('orders', $customer);
 +</code>
 +
 +==== Events ====
 +
 +<code php>
 +class Post extends ActiveRecord
 +{
 +  public function init()
 +  {
 +    $this->on('beforeAction', function($event) {
 +      // отменяем действие
 +      $event->isValid = false;
 +    });
 +  }
 +}
 +</code>
 +
 +<code php>
 +$component->on('beforeAction', $handler);
 +</code>
 +==== Как получить SQL и Параметры из ActiveQuery ====
 +
 +<code php>
 +$query = Post::find()->where(array('id' => 10, 'status' => Post::READ))->createCommand();
 +
 +// SQL
 +echo $query->sql
 +
 +// Params:
 +print_r($query->params)  
 +</code>
 +==== Объекты доступа к данным (Data Access Objects, DAO) ====
 +
 +=== Соеденение ===
 +
 +<code php>
 +$connection = \Yii::$app->db;
 +</code>
 +
 +**Подробно** 
 +
 +  * https://github.com/yiisoft/yii2/blob/master/docs/guide/database-basics.md
 +
 +=== Методы запроса ===
 +
 +  * queryOne()
 +  * queryAll()
 +  * query()
 +  * queryScalar()
 +  * queryColumn()
 +
 +**Подробно**  https://github.com/yiisoft/yii2/blob/master/framework/db/Command.php
 +
 +== createCommand ==
 +
 +<code php>
 +$command = $connection->createCommand('SELECT * FROM tbl_post WHERE id=1');
 +$post = $command->queryOne();
 +</code>
 +
 +<code php>
 +$connection->createCommand()->insert('tbl_user', [
 +    'name' => 'Sam',
 +    'age' => 30,
 +])->execute();
 +</code>
 +
 +<code php>
 +$command = $connection->createCommand('UPDATE tbl_post SET status=1 WHERE id=1');
 +$command->execute();
 +</code>
 +
 +<code php>
 +$connection->createCommand()->batchInsert('tbl_user', ['name', 'age'], [
 +    ['Tom', 30],
 +    ['Jane', 20],
 +    ['Linda', 25],
 +])->execute();
 +</code>
 +
 +<code php>
 +$connection->createCommand()->update('tbl_user', ['status' => 1], 'age > 30')->execute();
 +</code>
 +
 +<code php>
 +$connection->createCommand()->delete('tbl_user', 'status = 0')->execute();
 +</code>
 +
 +<code php>
 +$command = $connection->createCommand('SELECT * FROM tbl_post WHERE id=:id');
 +$command->bindValue(':id', $_GET['id']);
 +$post = $command->query();
 +</code>
 +
 +==== Построитель запросов (Query Builder and Query) ====
 +
 +<code php>
 +$rows = (new \yii\db\Query())
 +    ->select('id, name')
 +    ->from('user')
 +    ->limit(10)
 +    ->all();
 +
 +// which is equivalent to the following code:
 +
 +$query = (new \yii\db\Query())
 +    ->select('id, name')
 +    ->from('user')
 +    ->limit(10);
 +
 +// Create a command. You can get the actual SQL using $command->sql
 +$command = $query->createCommand();
 +
 +// Execute the command:
 +$rows = $command->queryAll();
 +</code>
 +
 +<code php>
 +$query = (new \yii\db\Query())
 +    ->select('id, name')
 +    ->from('user')
 +    ->limit(10);
 +
 +// Create a command. You can get the actual SQL using $command->sql
 +$command = $query->createCommand(Yii::$app->db);
 +
 +// Execute the command:
 +$rows = $command->queryAll();
 +</code>
 +
 +Простой спооб получить записи из указанной БД
 +
 +<code php>
 +$rows = (new \yii\db\Query())
 +    ->select('id, name')
 +    ->from('user')
 +    //->where([...])
 +    //->innerJoin('', '', [...])
 +    ->limit(10)
 +    ->createComand(Yii::$app->some_bd)
 +    ->queryAll();
 +</code>
 +
 +**Подробно** 
 +
 +  * https://github.com/yiisoft/yii2/blob/master/docs/guide/db-query-builder.md
 +
 +==== Transactions ====
 +
 +<code php>
 +$transaction = $connection->beginTransaction();
 +try {
 +    $connection->createCommand($sql1)->execute();
 +    $connection->createCommand($sql2)->execute();
 +    // ... executing other SQL statements ...
 +    $transaction->commit();
 +} catch(Exception $e) {
 +    $transaction->rollback();
 +}
 +</code>
 +
 +==== Batch ====
 +
 +=== Batch ===
 +
 +
 +<code php>
 +foreach (Customer::find()->batch() as $customers) {
 +
 +}
 +
 +foreach (Customer::find()->batch(10) as $customers) {
 +    // $customers — массив из 10 или менее объектов Customer
 +}
 +</code>
 +
 +<code php>
 +$rows = [];
 +
 +foreach ($models as $model) {
 +    if (!$model->validate()) {
 +        // At least one model has invalid data
 +
 +        break;
 +    }
 +
 +    $rows[] = $model->attributes;
 +}
 +$rows =  \yii\helpers\ArrayHelper::getColumn($models, 'attributes;');
 +$postModel = new Post;
 +
 +Yii::$app->db->createCommand()->batchInsert(Post::tableName(), $postModel->attributes(), $rows)->execute();
 +</code>
 +
 +=== Each ===
 +
 +<code php>
 +foreach (Customer::find()->each() as $customers) {
 +
 +}
 +
 +foreach (Customer::find()->each(10) as $customers) {
 +    // $customers — массив из 10 или менее объектов Customer
 +}
 +</code>
 +
 ===== Controller ===== ===== Controller =====
  
Строка 379: Строка 911:
 **Подробно** https://github.com/yiisoft/yii2/blob/master/docs/guide/url.md **Подробно** https://github.com/yiisoft/yii2/blob/master/docs/guide/url.md
  
 +===== Module =====
 +
 +==== Submodule ====
 +
 +Для работы сабмодуля, необходимо выполнить его подключение, через указание submodule namespace модуля
 +<code php>
 +namespace mirocow\eav;
 +
 +class Module extends \yii\base\Module {
 +  
 +    // ...
 +    public function init() {
 +
 +      // ..
 +
 +      $this->setModule('admin', 'yii\user\modules\admin\Module');
 +    }
 +  
 +    // Пример перенаправления роута в саб модуль admin
 +    public function createController($route) {
 +      
 +        return $this->getModule('admin')->createController(str_replace('admin/','',$route));
 +      
 +    }  
 +  
 +}
 +</code>
 +
 +==== Helpers ====
 +
 +  * https://github.com/yiisoft/yii2/blob/master/docs/guide/security.md
 +
 +==== Behaviors/Filters ====
 +
 +<code php>
 +public function behaviors()
 +{
 +  return array(
 +    'access' => array(
 +      'class' => 'yii\web\AccessControl',
 +      'rules' => array(
 +        array('allow' => true, 'actions' => array('admin'), 'roles' => array('@')),
 +        array('allow' => false),
 +      ),
 +    ),
 +  );
 +}
 +</code>
 +
 +==== Behaviors/Date ====
 +
 +<code php>
 +public function behaviors() {
 +  return [
 +    [
 +      'class' => TimestampBehavior::className(),
 +      'createdAtAttribute' => 'create_time',
 +      //'updatedAtAttribute' => 'update_time',
 +      'value' => new Expression('NOW()'),
 +    ],
 +  ];
 +}
 +</code>
 ===== Session ===== ===== Session =====
  
Строка 438: Строка 1033:
  }  }
 </code> </code>
 +
 +==== Params / Параметры ====
 +
 +<code php>
 +<?php
 +
 +namespace console\controllers;
 +
 +use yii\console\Controller;
 +
 +class QueueController extends Controller
 +{
 +    public $pid_file = '';
 +
 +    public function __get($name)
 +    {
 +        $name = str_replace('-', '_', $name);
 +
 +        return $this->$name;
 +    }
 +
 +    public function __set($name, $value)
 +    {
 +        $name = str_replace('-', '_', $name);
 +
 +        $this->$name = $value;
 +    }
 +
 +
 +    public function options($actionID)
 +    {
 +        return ['pid-file'];
 +    }
 +
 +    public function actionRun()
 +    {
 +
 +    }
 +}
 +</code>
 +
  
 ===== User ===== ===== User =====
Строка 469: Строка 1105:
 </code> </code>
  
 +
 +===== Components =====
 +
 +Создание объекта компанента
 +<code php>
 +$object = Yii::createObject(array(
 +    'class' => 'MyClass',
 +    'property1' => 'abc',
 +    'property2' => 'cde',
 +), $param1, $param2);
 +</code>
 +
 +===== Theme =====
 +
 +<code php>
 +'view' => array(
 +    'theme' => array(
 +        'pathMap' => array('@app/views' => '@webroot/themes/basic'),
 +        'baseUrl' => '@www/themes/basic',
 +    ),
 +),
 +</code>
  
 ===== Cache ===== ===== Cache =====
Строка 562: Строка 1220:
  
   apt=get install php5-intl   apt=get install php5-intl
 +
 +==== Перевод (локализация проекта) ====
 +
 +  * https://github.com/lajax/yii2-translate-manager
  
 ===== PHPUnit ===== ===== PHPUnit =====
Строка 577: Строка 1239:
     * php vendor/bin/phpunit vendor/yiisoft/yii2/yii/test/     * php vendor/bin/phpunit vendor/yiisoft/yii2/yii/test/
  
-===== Статьи =====+====== Статьи ======
  
   * https://github.com/yiisoft/yii2/blob/master/docs/guide-ru/caching-data.md   * https://github.com/yiisoft/yii2/blob/master/docs/guide-ru/caching-data.md
Строка 583: Строка 1245:
   * http://habrahabr.ru/post/208328/   * http://habrahabr.ru/post/208328/
  
-===== Описание =====+====== Описание ======
  
   * https://github.com/yiisoft/yii2/blob/master/docs/guide/i18n.md#advanced-placeholder-formatting   * https://github.com/yiisoft/yii2/blob/master/docs/guide/i18n.md#advanced-placeholder-formatting