Yii - Активная запись

Active Record предоставляет объектно-ориентированный API для доступа к данным. Класс Active Record связан с таблицей базы данных.

Yii предоставляет поддержку Active Record для следующих реляционных баз данных:

  • MySQL 4.1 или новее
  • SQLite 2 и 3:
  • PostgreSQL 7.3 или новее
  • Microsoft SQL Server 2008 или новее
  • CUBRID 9.3 или новее
  • Oracle
  • ElasticSearch
  • Sphinx

Кроме того, класс Active Record поддерживает следующие NoSQL базы данных -

  • Redis 2.6.12 или новее
  • MongoDB 1.3.0 или новее

После объявления класса Active Record (MyUser модель в нашем случае) для отдельной таблицы базы данных, вы должны выполнить следующие шаги, чтобы запросить данные из нее:

  • Создайте новый объект запроса, используя метод yii \ db \ ActiveRecord :: find ().
  • Создайте объект запроса.
  • Вызовите метод запроса для получения данных.

Step 1 - Измените actionTestDb() метод таким образом.

public function actionTestDb() {
   // return a single user whose ID is 1
   // SELECT * FROM `user` WHERE `id` = 1
   $user = MyUser::find() ->where(['id' => 1]) ->one(); var_dump($user);
   // return the number of users
   // SELECT COUNT(*) FROM `user`
   $users = MyUser::find() ->count(); var_dump($users);
   // return all users and order them by their IDs
   // SELECT * FROM `user` ORDER BY `id`
   $users = MyUser::find() ->orderBy('id') ->all(); var_dump($users);
}

Приведенный выше код показывает, как использовать ActiveQuery для запроса данных.

Step 2 - Перейти к http://localhost:8080/index.php?r=site/test-db, вы увидите следующий результат.

Запросы по значениям первичного ключа или набору значений столбцов - обычная задача, поэтому Yii предоставляет следующие методы:

  • yii\db\ActiveRecord::findOne() - Возвращает один экземпляр Active Record

  • yi\db\ActiveRecord::findAll() - Возвращает массив экземпляров Active Record

Example -

public function actionTestDb() {
   // returns a single customer whose ID is 1
   // SELECT * FROM `user` WHERE `id` = 1
   $user = MyUser::findOne(1); var_dump($user);
   // returns customers whose ID is 1,2,3, or 4
   // SELECT * FROM `user` WHERE `id` IN (1,2,3,4)
   $users = MyUser::findAll([1, 2, 3, 4]); var_dump($users);
   // returns a user whose ID is 5
   // SELECT * FROM `user` WHERE `id` = 5
   $user = MyUser::findOne([ 'id' => 5 ]); var_dump($user);
}

Сохранить данные в базу данных

Для сохранения данных в базе необходимо вызвать yii\db\ActiveRecord::save() метод.

Step 1 - Измените actionTestDb() метод таким образом.

public function actionTestDb() {
   // insert a new row of data
   $user = new MyUser(); $user->name = 'MyCustomUser2';
   $user->email = '[email protected]'; $user->save();
   var_dump($user->attributes); // update an existing row of data $user = MyUser::findOne(['name' => 'MyCustomUser2']);
   $user->email = '[email protected]'; $user->save();
   var_dump($user->attributes);
}

Step 2 - Перейти к http://localhost:8080/index.php?r=site/test-db, вы увидите следующий результат.

Чтобы удалить одну строку данных, вы должны:

  • Получить экземпляр Active Record

  • Позвоните в yii\db\ActiveRecord::delete() метод

Step 1 - Измените actionTestDb() метод таким образом.

public function actionTestDb() {
   $user = MyUser::findOne(2);
   if($user->delete()) {
      echo "deleted";
   } 
}

Step 2 - Тип http://localhost:8080/index.php?r=site/test-db в адресной строке веб-браузера вы увидите следующий результат.

Step 3 - Вы также можете позвонить в yii\db\ActiveRecord::deleteAll() например, для удаления нескольких строк данных.

public function actionTestDb() {
    MyUser::deleteAll('id >= 20');
}