Yii2 - 数据库访问对象

配置好数据库连接后，你就可以通过下面的语法来使用了：

1	$connection= \Yii::$app->db;

你可以参考 [[yii\db\Connection]] 以了解有哪些属性可以配置。而且你可以配置多个连接，在应用程序中同时使用它们：

1 2	$primaryConnection= \Yii::$app->db; $secondaryConnection= \Yii::$app->secondDb;

如果你不想把数据库连接定义为应用程序的组件，你也可以直接创建一个实例：

1 2 3 4 5 6

$connection=new \yii\db\Connection([     'dsn'=>$dsn,      'username'=>$username,      'password'=>$password, ]); $connection->open();

提示：如果你需要在建立连接时执行额外的SQL查询，你可以添加如下配置：

1 2 3 4 5 6 7 8 9 10 11 12 13 14

return [     // ...     'components'=> [         // ...         'db'=> [             'class'=>'yii\db\Connection',             // ...             'on afterOpen'=>function($event) {                 $event->sender->createCommand("SET time_zone = 'UTC'")->execute();             }         ],     ],     // ... ];

 

基本SQL查询

有了数据库连接实例，你可以使用 [[yii\db\Command]] 来执行SQL查询。

SELECT

返回多行数据：

1 2	$command = $connection->createCommand('SELECT * FROM post'); $posts = $command->queryAll();

返回单行数据：

1 2	$command = $connection->createCommand('SELECT * FROM post WHERE id=1'); $post = $command->queryOne();

返回列数据：

1 2	$command = $connection->createCommand('SELECT title FROM post'); $titles = $command->queryColumn();

返回统计数：

1 2	$command = $connection->createCommand('SELECT COUNT(*) FROM post'); $postCount=$command->queryScalar();

UPDATE, INSERT, DELETE etc.

对于非查询语句，你可以使用[[ yii\db\Command]]的 execute 方法：

1 2	$command = $connection->createCommand('UPDATE post SET status=1 WHERE id=1'); $command->execute();

也可以使用下面的语法，会自动处理好表名和列名引用：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

// INSERT $connection->createCommand()->insert('user', [     'name'=>'Sam',     'age'=> 30, ])->execute();   // INSERT multiple rows at once $connection->createCommand()->batchInsert('user', ['name','age'], [     ['Tom', 30],     ['Jane', 20],     ['Linda', 25], ])->execute();   // UPDATE $connection->createCommand()->update('user', ['status'=> 1], 'age > 30')->execute();   // DELETE $connection->createCommand()->delete('user','status = 0')->execute();

 

引用表名和列名

大多数情况下，你使用如下语法引用表名和列名：

1 2	$sql = "SELECT COUNT([[$column]]) FROM {{$table}}"; $rowCount=$connection->createCommand($sql)->queryScalar();

在上述代码中 [[$column]] 将被转换为合适的列名引用，而 {{$table}} 将被转换为表名引用。

对于表名，有一个特殊变量 {{%$table}} ，会自动为表名添加前缀（如果有的话）：

1 2	$sql = "SELECT COUNT([[$column]]) FROM {{%$table}}"; $rowCount=$connection->createCommand($sql)->queryScalar();

上述代码将会应用于 tbl_table ，如果你在配置文件中配置了如下的表前缀的话：

1 2 3 4 5 6 7 8 9 10

return [     // ...     'components'=> [         // ...         'db'=> [             // ...             'tablePrefix'=>'tbl_',         ],     ], ];

另外一个可选方法是使用[[yii\db\Connection::quoteTableName()]]和 [[yii\db\Connection::quoteColumnName()]] 方法来手动引用：

1 2 3 4

$column = $connection->quoteColumnName($column); $table = $connection->quoteTableName($table); $sql = "SELECT COUNT($column) FROM $table"; $rowCount=$connection->createCommand($sql)->queryScalar();

 

在Model　或 Controller中获取表前缀

var_dump(Admin::getDb()->tablePrefix); exit();

预备声明（Prepared statements）

为了安全传递查询参数，你可以使用预备声明（prepared statements），（译注：先声明参数，对用户输入进行escape后，进行参数替换，主要为了防止SQL注入）：

1 2 3

$command = $connection->createCommand('SELECT * FROM post WHERE id=:id'); $command->bindValue(':id',$_GET['id']); $post = $command->query();

此外，使用预备声明还可以对查询命令进行复用，如下使用不同的参数查询只需要准备一次command：

1 2 3 4 5 6 7 8

$command = $connection->createCommand('DELETE FROM post WHERE id=:id'); $command->bindParam(':id',$id);   $id = 1; $command->execute();   $id = 2; $command->execute();

 

事务（Transaction）

你可以向下面这样执行一个数据库事务：

1 2 3 4 5 6 7 8 9

$transaction=$connection->beginTransaction(); try {     $connection->createCommand($sql1)->execute();      $connection->createCommand($sql2)->execute();     // ... 执行查询语句  ...     $transaction->commit(); } catch(Exception$e) {     $transaction->rollBack(); }

还可以嵌套事务：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

// 外层事务 $transaction1=$connection->beginTransaction(); try {     $connection->createCommand($sql1)->execute();       // 内层事务     $transaction2=$connection->beginTransaction();     try{         $connection->createCommand($sql2)->execute();         $transaction2->commit();     }catch(Exception $e) {         $transaction2->rollBack();     }       $transaction1->commit(); } catch(Exception$e) {     $transaction1->rollBack(); }