Yii Framework 公式ガイドシリーズ 24 - データベースの使用: クエリビルダー-PHPチュートリアル-php.cn

ホームページ

バックエンド開発

PHPチュートリアル

Yii Framework 公式ガイドシリーズ 24 - データベースの使用: クエリビルダー

黄舟

Feb 13, 2017 am 09:24 AM

Yii フレームワークのクエリビルダーは、SQL ステートメントを記述するためのオブジェクト指向の方法を提供し、開発者がクラスメソッドとプロパティを使用して SQL ステートメントの独立した部分を指定し、これらの異なる部分を 1 つに組み立てることができます。前の章で説明したように DAO メソッドを呼び出して、SQL ステートメントを実行できます。以下は、クエリビルダーを使用して SELECT SQL ステートメントを構築する一般的な方法を示しています:

$user = Yii::app()->db->createCommand()
    ->select('id, username, profile')
    ->from('tbl_user u')
    ->join('tbl_profile p', 'u.id=p.user_id')
    ->where('id=:id', array(':id'=>$id))
    ->queryRow();

SQL ステートメントをチャンクで組み立てる必要がある場合、または特殊な条件に基づいてクエリビルダーを使用するのが最適です。クエリビルダーを使用する最大の利点は次のとおりです:

複雑な SQL ステートメントを作成できる
SQL の予約語や特殊文字との競合を避けるために、テーブル名と列名を自動的に引用符で囲みます。
可能であればパラメータ値も使用します。 SQL インジェクション攻撃を軽減できるパラメータバインディングを実行します。
異なるデータベースプラットフォーム間のデータベース移行を簡素化できる、ある程度のデータベース抽象化をサポートします。

実際、これは必須ではありません。クエリが非常に単純な場合は、SQL ステートメントを直接使用する方が簡単で高速です。次のコードは無効です:

$command = Yii::app()->db->createCommand('SELECT * FROM tbl_user');
// the following line will NOT append WHERE clause to the above SQL
$command->where('id=:id', array(':id'=>$id));

つまり、ネイティブ SQL と SQL およびクエリビルダーの使用を修正しないでください。

1. クエリビルダーを準備します

Yii フレームワークのクエリビルダーがサポートされています。 CDbCommand の形式で、このデータベースクエリクラスは DAO の章で説明されています。

クエリビルダーを使用する前に、以下に示すように、まず CDbCommand のインスタンスを作成する必要があります

$command = Yii::app()->db->createCommand();

つまり、Yii::app()- >db を使用して DB 接続を取得し、CDbConnection::createCommand() を呼び出して必要なコマンドインスタンスを作成します

。 DAO の場合のように、SQL ステートメント全体をパラメータを渡さずに

createCommand() メソッドに渡すわけではないことに注意してください。これは、クエリ ビルダー メソッドを使用して独立した SQL ステートメントを構築するためです。データ取得クエリ<p><code>Yii::app()->db

来获取 DB 连接, 然后调用 CDbConnection::createCommand() 来创建所需的command 实例.

注意我们并没有像在DAO中一样将整个SQL语句传入createCommand()方法中调用,而是没有传入任何参数. 这是因为我们接下来将会使用Query Builder 的方法来构建独立的SQL语句.

2. 构建数据检索查询

数据检索查询使用 SELECT 语句. query builder提供了一系列的方法来构建独立的SELECT语句.因为这些方法返回的都是 CDbCommand 实例, 所以我们可以使用方法链, 正如我们这一章节的开头所示那样.

select(): 指定查询的SELECT 部分
selectDistinct(): 指定查询的SELECT 部分并且开启DISTINCT标识符
from(): 指定查询的FROM部分
where(): 指定查询的WHERE部分
andWhere(): 使用AND操作符添加条件到查询的 WHERE 部分
orWhere(): 使用OR操作符添加条件到查询的 WHERE 部分
join(): 添加内联查询
leftJoin(): 添加左外联接
rightJoin():添加右外联接查询
crossJoin(): 添加交叉联接查询
naturalJoin(): 添加自然联接查询
group(): 指定查询的GROUP BY部分
having(): 指定查询的HAVING部分
order(): 指定查询的 ORDER BY 部分
limit(): 指定查询的LIMIT 部分
offset(): 指定查询的 OFFSET 部分
union(): 添加 UNION 查询

接下来我们会阐述如何使用这些构建方法. 简单起见, 我们假设使用的数据库是MySQL. 注意如果你使用的是其他DBMS，示例中table/column/value 的引用可能会不一样.

select()

function select($columns='*')

select() 方法指定查询的SELECT 部分. $columns 参数指定被查询的列, 可以是以逗号分割的字符串, 也可以是包含列名的数组.列名可以包含表前缀及列的别名. 这个方法会自动引用列名，除非该列是DB expression.

下面是示例:

// SELECT *
select()
// SELECT `id`, `username`
select('id, username')
// SELECT `tbl_user`.`id`, `username` AS `name`
select('tbl_user.id, username as name')
// SELECT `id`, `username`
select(array('id', 'username'))
// SELECT `id`, count(*) as num
select(array('id', 'count(*) as num'))

selectDistinct()

function selectDistinct($columns)

selectDistinct() 和select()类似，不同之处是前者开启了 DISTINCT . 例如,selectDistinct('id, username') データ取得クエリ SELECT ステートメントの使用。クエリビルダーは、独立した SELECT ステートメントを構築するための一連のメソッドを提供します。これらのメソッドは CDbCommand インスタンスを返すため、この章の冒頭で示したように、メソッドチェーンを使用できます。

select(): クエリの SELECT 部分を指定します

selectDistinct(): クエリの SELECT 部分を指定し、DISTINCT 識別子を有効にします

from(): クエリの FROM 部分を指定します

where(): クエリの WHERE 部分を指定します

andWhere(): AND 演算子を使用してクエリの WHERE 部分に条件を追加します

orWhere(): OR 演算子を使用して条件を追加しますクエリの WHERE 部分に

join() : インラインクエリを追加

leftJoin(): 左外部結合を追加🎜🎜🎜🎜rightJoin(): 右外部結合クエリを追加🎜🎜🎜🎜crossJoin() : クロス結合クエリを追加します🎜🎜🎜🎜naturalJoin(): ナチュラル結合クエリを追加します🎜🎜🎜🎜group(): クエリの GROUP BY 部分を指定します🎜🎜🎜🎜having(): クエリの HAVING 部分を指定します🎜 🎜🎜🎜order(): クエリのORDER BY部分を指定🎜🎜🎜🎜limit(): クエリのLIMIT部分を指定🎜🎜🎜🎜offset(): クエリのOFFSET部分を指定🎜🎜🎜🎜union (): UNION クエリを追加します🎜🎜🎜🎜 次に、これらの構築方法の使用方法を説明します。簡単にするために、使用するデータベースは MySQL であると仮定します。別の DBMS を使用している場合は、table/column/ への参照に注意してください。例の値は異なる場合があります。🎜🎜🎜select()🎜🎜🎜🎜🎜🎜🎜

SELECT DISTINCT `id`, `username`

🎜🎜🎜select() メソッドは、クエリの SELECT 部分を指定します。パラメータは、クエリ対象の列を指定します。これは、カンマ区切りの文字列または列名を含む配列にすることができます。列名には、テーブルの接頭辞と列の別名を含めることができます。は DB 式です。 🎜🎜 以下に例を示します。 🎜🎜🎜🎜🎜🎜

function from($tables)

🎜🎜🎜selectDistinct()🎜🎜🎜🎜🎜🎜

// FROM `tbl_user`
from('tbl_user')
// FROM `tbl_user` `u`, `public`.`tbl_profile` `p`
from('tbl_user u, public.tbl_profile p')
// FROM `tbl_user`, `tbl_profile`
from(array('tbl_user', 'tbl_profile'))
// FROM `tbl_user`, (select * from tbl_profile) p
from(array('tbl_user', '(select * from tbl_profile) p'))

🎜🎜🎜selectDistinct() は select() と似ていますが、以前のターンたとえば、selectDistinct('id, username') は次の SQL を生成します:🎜

function where($conditions, $params=array())

🎜from()🎜🎜🎜🎜🎜🎜

array(operator, operand1, operand2, ...)

🎜🎜🎜 from() メソッドは、クエリの FROM 部分を指定します。 $tables パラメータは、カンマ区切りの文字列テーブル名、またはテーブル名を含む配列を指定します。 tbl_user) とテーブルエイリアス (例: tbl_user u)。このメソッドは、挿入ステートメントが含まれていない限り、テーブル名を自動的に参照します (テーブル名は、クエリまたは DB 式の形式で指定されたサブルーチンで終わります)。いくつかの例を次に示します。 🎜🎜🎜🎜🎜🎜

// WHERE id=1 or id=2
where('id=1 or id=2')
// WHERE id=:id1 or id=:id2
where('id=:id1 or id=:id2', array(':id1'=>1, ':id2'=>2))
// WHERE id=1 OR id=2
where(array('or', 'id=1', 'id=2'))
// WHERE id=1 AND (type=2 OR type=3)
where(array('and', 'id=1', array('or', 'type=2', 'type=3')))
// WHERE `id` IN (1, 2)
where(array('in', 'id', array(1, 2))
// WHERE `id` NOT IN (1, 2)
where(array('not in', 'id', array(1,2)))
// WHERE `name` LIKE '%Qiang%'
where(array('like', 'name', '%Qiang%'))
// WHERE `name` LIKE '%Qiang' AND `name` LIKE '%Xue'
where(array('like', 'name', array('%Qiang', '%Xue')))
// WHERE `name` LIKE '%Qiang' OR `name` LIKE '%Xue'
where(array('or like', 'name', array('%Qiang', '%Xue')))
// WHERE `name` NOT LIKE '%Qiang%'
where(array('not like', 'name', '%Qiang%'))
// WHERE `name` NOT LIKE '%Qiang%' OR `name` NOT LIKE '%Xue%'
where(array('or not like', 'name', array('%Qiang%', '%Xue%')))

🎜🎜🎜どこ()🎜🎜🎜🎜🎜🎜

$keyword=$_GET['q'];
// escape % and _ characters
$keyword=strtr($keyword, array('%'=>'\%', '_'=>'\_'));
$command->where(array('like', 'title', '%'.$keyword.'%'));

🎜🎜

where() 方法指定了查询的 WHERE 部分. $conditions 指定查询的条件，$params 指定查询条件中的参数.e $conditions参数可能是一个字符串也可能是数组如下所示:

array(operator, operand1, operand2, ...)

里面的 operator 可以下列所示的任意一个:

and: 操作数通过 AND连接到一起. 例如, array('and', 'id=1', 'id=2') 将会生成 id=1 AND id=2. 如果一个操作数是数组, 那么它将会通过同样的规则转化为字符串. 例如, array('and', 'type=1', array('or', 'id=1', 'id=2')) 将会生成 type=1 AND (id=1 OR id=2). 这个方法不会做任何引用和转义.
or: 和 and 操作符类似，不同之处在于操作数使用OR连接到一起.
in: 第一个操作数operand1应该是一个列名或者DB expression, 第二个操作数operand2是一个表示该列或DB expression所在范围的数组, array('in', 'id', array(1,2,3)) 将会生成 id IN (1,2,3). 这个方法将会引用列名并转义取值范围中的值.
not in: 和in 操作符类似，不同之处是在生成条件语句中将 IN 换成 NOT IN .
like: 操作符operand 1应该是一个列或者 DB expression, 操作符operand 2是一个表示与列或者DB expression相似的字符串或数组. 例如,array('like', 'name', '%tester%') 将会生成 name LIKE '%tester%'. 当值的范围是数组形式的时候, 多个 LIKE 语句会通过AND 连接起来. 例如, array('like', 'name', array('%test%', '%sample%')) 将生成 name LIKE '%test%' AND name LIKE '%sample%'. 这个方法将会引用列名并转义取值范围中的值.
not like: 和 like 操作符类似
or like: 和 like 操作符类似，不同之处是多个LIKE之间使用 OR 连接.
or not like: 和 not like 操作符类似.

下面是使用 where的一些示例:

// WHERE id=1 or id=2
where('id=1 or id=2')
// WHERE id=:id1 or id=:id2
where('id=:id1 or id=:id2', array(':id1'=>1, ':id2'=>2))
// WHERE id=1 OR id=2
where(array('or', 'id=1', 'id=2'))
// WHERE id=1 AND (type=2 OR type=3)
where(array('and', 'id=1', array('or', 'type=2', 'type=3')))
// WHERE `id` IN (1, 2)
where(array('in', 'id', array(1, 2))
// WHERE `id` NOT IN (1, 2)
where(array('not in', 'id', array(1,2)))
// WHERE `name` LIKE '%Qiang%'
where(array('like', 'name', '%Qiang%'))
// WHERE `name` LIKE '%Qiang' AND `name` LIKE '%Xue'
where(array('like', 'name', array('%Qiang', '%Xue')))
// WHERE `name` LIKE '%Qiang' OR `name` LIKE '%Xue'
where(array('or like', 'name', array('%Qiang', '%Xue')))
// WHERE `name` NOT LIKE '%Qiang%'
where(array('not like', 'name', '%Qiang%'))
// WHERE `name` NOT LIKE '%Qiang%' OR `name` NOT LIKE '%Xue%'
where(array('or not like', 'name', array('%Qiang%', '%Xue%')))

值得注意的是当操作符包含like的时候,我们必须在patterns明确指定通配符字符串 (such as % and _). 如果 patterns 来自用户输入,我们还要使用下面的代码来转义特殊字符以避免被作为通配符处理:

$keyword=$_GET['q'];
// escape % and _ characters
$keyword=strtr($keyword, array('%'=>'\%', '_'=>'\_'));
$command->where(array('like', 'title', '%'.$keyword.'%'));

andWhere()

function andWhere($conditions, $params=array())

addWhere() 方法通过AND操作符添加额外的条件到查询的WHERE部分，这个方法和行为和where()几乎一样，不同之处是它追加条件而不是替换.

orWhere()

function orWhere($conditions, $params=array())

orWhere() 方法通过OR操作符添加额外的条件到查询的WHERE部分，这个方法和行为和where()几乎一样，不同之处是它追加条件而不是替换.

order()

function order($columns)

order() 方法指定查询的 ORDER BY 部分. $columns 参数指定要排序的列, 可以是以逗号分隔的列和排序方向(ASCor DESC)字符串，或者包含列和排序方向的数组. 列名可能包含表前缀. 该方法会自动引用列名，除非该列名是一些插入语句 (如DB expression).

下面是一些示例:

// ORDER BY `name`, `id` DESC
order('name, id desc')
// ORDER BY `tbl_profile`.`name`, `id` DESC
order(array('tbl_profile.name', 'id desc'))

limit() 和 offset()

function limit($limit, $offset=null)
function offset($offset)

limit() 和 offset() 方法指定查询的 LIMIT 和 OFFSET 部分. 注意一些 DBMS 可能不支持 LIMIT 和 OFFSET 语法. 在这种情况下, Query Builder 将会重写整个 SQL 语句来模拟limit 和 offset的功能.

下面是一些示例:

// LIMIT 10
limit(10)
// LIMIT 10 OFFSET 20
limit(10, 20)
// OFFSET 20
offset(20)

join() 及其变种

function join($table, $conditions, $params=array())
function leftJoin($table, $conditions, $params=array())
function rightJoin($table, $conditions, $params=array())
function crossJoin($table)
function naturalJoin($table)

join() 方法及其变种指定了使用 INNER JOIN, LEFT OUTER JOIN,RIGHT OUTER JOIN, CROSS JOIN, 或者 NATURAL JOIN联接其他表进行查询. $table 参数指定了要联接的表名. 表名可以包含作用域前缀及别名. 这个方法将会引用表名（除非表名是DB expression或者子查询）. $conditions参数指定了联接条件，它的语法和where()类似. $params 指定了整个查询的参数绑定.

注意不同于其他 query builder 方法, 每一次调用 join 方法都会追加到前一个上去.

下面是一些示例:

// JOIN `tbl_profile` ON user_id=id
join('tbl_profile', 'user_id=id')
// LEFT JOIN `pub`.`tbl_profile` `p` ON p.user_id=id AND type=1
leftJoin('pub.tbl_profile p', 'p.user_id=id AND type=:type', array(':type'=>1))

group()

function group($columns)

group() 方法指定查询的 GROUP BY 部分. $columns 参数指定分组的列, 可以是以逗号分隔的列字符串, 也可以是列数组。列名可能包含表前缀. 这个方法会自动引用列名，除非列是插入语句(which means the column is given as a DB expression).

下面是一些示例:

// GROUP BY `name`, `id`
group('name, id')
// GROUP BY `tbl_profile`.`name`, `id`
group(array('tbl_profile.name', 'id'))

having()

function having($conditions, $params=array())

having() 方法指定了查询的 HAVING 部分. 它的使用 where()类似.

下面是一些示例:

// HAVING id=1 or id=2
having('id=1 or id=2')
// HAVING id=1 OR id=2
having(array('or', 'id=1', 'id=2'))

union()

function union($sql)

union() 方法指定了查询的 UNION 部分. 它使用UNION操作符追加 $sql 到已存在的 SQL. 调用 union() 多次将会追加多个 SQLs 到已存在的SQL上.

下面是一些示例:

// UNION (select * from tbl_profile)
union('select * from tbl_profile')

执行查询

在调用上述的查询构建方法构建一个查询之后, 我们可以调用如上一章节DAO中所述的DAO方法来执行查询. 例如, 我们可以调用 CDbCommand::queryRow() 来获取一行的结果, 或者 CDbCommand::queryAll() 来一次获取所有结果. 例子:

$users = Yii::app()->db->createCommand()
    ->select('*')
    ->from('tbl_user')
    ->queryAll();

检索SQL

除了执行 Query Builder构建的查询之外, 我们还可以检索相应SQL语句的结果. 这可以通过调用 CDbCommand::getText()方法来解决.

$sql = Yii::app()->db->createCommand()
    ->select('*')
    ->from('tbl_user')
    ->text;

如果有多个参数绑定到一个查询上, 那么它们可以通过 CDbCommand::paramsproperty来获取结果.

构建查询的可选语法

有时候, 使用方法链来构建查询并不是一个明智的选择. Yii框架的 Query Builder允许一个查询使用简单对象属性赋值的方式来构建 . 特别地，对每一个查询构建方法，有一个同名的相应属性. 赋值到该属性等价于调用相应的方法. 例如，下面的两个语句是等价的（$command 代表 CDbCommand 对象）:

$command->select(array('id', 'username'));
$command->select = array('id', 'username');

此外, CDbConnection::createCommand()方法可以传入一个数组参数. 数组中的键值对会被用来初始化已创建的CDbCommand实例的属性.这意味着，我们可以使用下面的代码来构建查询:

$row = Yii::app()->db->createCommand(array(
    'select' => array('id', 'username'),
    'from' => 'tbl_user',
    'where' => 'id=:id',
    'params' => array(':id'=>1),
))->queryRow();

构建多个查询

一个DbCommand 实例可以被多次复用来构建多个查询. 在构建一个新的查询之前一定要调用 CDbCommand::reset() 方法来清除上一个查询. 例如:

$command = Yii::app()->db->createCommand();
$users = $command->select('*')->from('tbl_users')->queryAll();
$command->reset();  // clean up the previous query
$posts = $command->select('*')->from('tbl_posts')->queryAll();

3. 构建数据操纵（增、删、改）SQL语句

数据操纵查询指的是SQL语句中数据库表格记录的插入、更新和删除. 与之相应的，查询构建器提供了insert，update和delete方法. 不同于 SELECT 查询方法，每一个数据操纵查询方法都会构建一个完整的SQL语句，并且立即执行.

insert(): 在数据表中插入一行
update(): 更新数据表数据
delete(): 从数据表删除数据

下面我们阐述数据操纵查询方法.

insert()

function insert($table, $columns)

insert() 方法构建并执行一个 INSERT SQL 语句. $table参数指定要插入的数据表, $columns是一个键值对数组，指定了插入的列及对应的值. 这个方法会引用表名并且使用绑定参数.

Below is an example:

// build and execute the following SQL:
// INSERT INTO `tbl_user` (`name`, `email`) VALUES (:name, :email)
$command->insert('tbl_user', array(
    'name'=>'Tester',
    'email'=>'tester@example.com',
));

update()

function update($table, $columns, $conditions='', $params=array())

update() 方法构建并执行一个UPDATE SQL语句. $table参数指定要更新的表; $columns是一个键值对数组，该数组指定了要更新的列及其对应的值;$conditions 和 $params 和 where()中的类似, 指定了UPDATE语句中的 WHERE部分. 这个方法会自动引用相应的列名并且使用参数绑定.

Below is an example:

// build and execute the following SQL:
// UPDATE `tbl_user` SET `name`=:name WHERE id=:id
$command->update('tbl_user', array(
    'name'=>'Tester',
), 'id=:id', array(':id'=>1));

delete()

function delete($table, $conditions='', $params=array())

delete() 方法构建并执行一个DELETE SQL语句. $table参数指定要删除的表; $conditions 和 $params 和 where()中的类似, 指定了DELETE语句中的 WHERE部分. 这个方法会自动引用相应的列名.

下面是示例:

// build and execute the following SQL:
// DELETE FROM `tbl_user` WHERE id=:id
$command->delete('tbl_user', 'id=:id', array(':id'=>1));

4. 构建数据表操作SQL语句

除了正常的数据取回和操纵查询, query builder 还提供了一系列的方法来构建和执行操作数据库层面的SQL操作. 特殊地，它支持下列查询:

createTable(): 创建表
renameTable(): 重命名表
dropTable(): 删除表
truncateTable(): 清空表
addColumn(): 新增表的列
renameColumn(): 重命名表的列
alterColumn(): 修改表的列
addForeignKey(): 添加外键（版本1.1.6起生效）
dropForeignKey(): 删除外键 (版本1.1.6起生效)
dropColumn(): 删除表列
createIndex(): 创建索引
dropIndex(): 删除索引

Info: 尽管实际的SQL语句在不同的DBMS中操作数据库的方法不尽相同，但是查询构建器试图提供一个统一接口来构建查询。这极大简化了数据库迁移时带来的麻烦。

抽象数据类型

query builder 介绍了一系列抽象数据类型用来定义数据表的列. 不同于物理数据类型用来指定特殊的DBMS而且在不同的DBMS中不一样，这里的抽象数据类型独立于DBMS. 当抽象数据类型用于定义表的列时，查询构建器将会将其转化为相应的物理数据类型.

下面的抽象数据类型都被 query builder 所支持.

pk: 一个通用的主键类型, 在MySQL中将会被转化为 int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY;
string: 字符串类型, 在MySQL中将会被转化为 varchar(255);
text: 文本类型 (长字符串), 在MySQL中将会被抓化为 text;
integer: 整型, 在MySQL中将会被转化为 int(11);
float: 浮点数类型, 在MySQL中将会被转化为will be converted into float;
decimal: 小数类型, 在MySQL中将会被转化为 decimal;
datetime: 日期时间类型, 在MySQL中将会被转化为 datetime ;
timestamp: 时间戳类型,在MySQL中将会被转化为 timestamp ;
time: 时间类型, 在MySQL中将会被转化为 time;
date: 日期类型, 在MySQL中将会被转化为 date;
binary: 二进制数据类型, 在MySQL中将会被转化为 blob;
boolean: 布尔类型, 在MySQL中将会被转化为tinyint(1);
money: 金钱/货币类型, 在MySQL中将会被转化为 decimal(19,4). 这个类型从Yii版本1.1.8起生效.

createTable()

function createTable($table, $columns, $options=null)

createTable() 方法构建和执行创建数据表的 SQL语句. $table参数指定了要创建的表名. $columns 参数指定了新表中的列. 它们必须定义为 name-definition 对 (e.g. 'username'=>'string'). $options 参数指定任意额外的应该追加到已生成的SQL语句的SQL 片段 . query builder 将会引用表名和合适的列名.

当指定一个列定义时，可以使用上述所叙的抽象数据类型. query builder 会基于当前使用的DBMS转化抽象数据类型为相应的物理数据类型。 

一个列定可以包含非抽象数据类型或者指定. 它们将会毫无改变的生成 SQL 语句。例如, point 不是一个抽象数据类型, 如果用在了列定义中, 它将会出现在结果SQL语句中，同时string NOT NULL 将会转化为 varchar(255) NOT NULL.

下面的例子展示了如何创建新表:

// CREATE TABLE `tbl_user` (
//     `id` int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY,
//     `username` varchar(255) NOT NULL,
//     `location` point
// ) ENGINE=InnoDB
createTable('tbl_user', array(
    'id' => 'pk',
    'username' => 'string NOT NULL',
    'location' => 'point',
), 'ENGINE=InnoDB')

renameTable()

function renameTable($table, $newName)

renameTable() 方法构建并执行重命名表的SQL语句. $table参数指定了要重命名的表，$newName参数指定了表的新名称. 查询构建器将会引用合适的表名.

下面的示例展示了如何重命名一个表:

// RENAME TABLE `tbl_users` TO `tbl_user`
renameTable('tbl_users', 'tbl_user')

dropTable()

function dropTable($table)

dropTable() 方法构建并执行删除表的SQL语句. $table 参数指定要删除的表名. query builder将会引用合适的表名.

下面是展示如何删除表的示例:

// DROP TABLE `tbl_user`
dropTable('tbl_user')

truncateTable()

function truncateTable($table)

truncateTable() 方法会构建并执行清空表的SQL语句. $table参数指定要清空的表名.query builder将会引用合适的表名.

下面是展示如何清空表的示例:

// TRUNCATE TABLE `tbl_user`
truncateTable('tbl_user')

addColumn()

function addColumn($table, $column, $type)

addColumn() 方法构建并执行 SQL语句来添加一个新的列，$table参数指定新增列的表名. $column 参数指定新增列的名称. $type 指定了新增列的定义. 列定义可能包含抽象数据类型, 这在 "createTable"里已经说明过. query builder 将会引用表名和合适的列名.

下面展示的是如何为表新增列的例子:

// ALTER TABLE `tbl_user` ADD `email` varchar(255) NOT NULL
addColumn('tbl_user', 'email', 'string NOT NULL')

dropColumn()

function dropColumn($table, $column)

dropColumn() 方法构建并执行删除表的列的SQL语句. $table参数指定了要删除列的表名. $column 参数指定了要删除的列名. query builder 将会引用表名和合适的列名.

下面是如何删除表列的例子:

// ALTER TABLE `tbl_user` DROP COLUMN `location`
dropColumn('tbl_user', 'location')

renameColumn()

function renameColumn($table, $name, $newName)

renameColumn() 方法构建并执行重命名表的列的SQL语句. $table参数指定了要重命名列的表名. $name参数指定了旧的列名. $newName 参数指定了新的列名. query builder 将会引用表名和合适的列名.

下面展示了如何重命名一个表的列:

// ALTER TABLE `tbl_users` CHANGE `name` `username` varchar(255) NOT NULL
renameColumn('tbl_user', 'name', 'username')

alterColumn()

function alterColumn($table, $column, $type)

alterColumn() 方法构建并执行修改表列的 SQL 语句 . $table参数指定了将要被修改列的表名. $column 参数指定了将要被修改的列名.$type 指定了列的新定义，列定义可能包含抽象数据类型. query builder将会引用表名和合适的列名.

下面展示了如何修改一个表的列:

// ALTER TABLE `tbl_user` CHANGE `username` `username` varchar(255) NOT NULL
alterColumn('tbl_user', 'username', 'string NOT NULL')

addForeignKey()

function addForeignKey($name, $table, $columns,
    $refTable, $refColumns, $delete=null, $update=null)

addForeignKey() 方法构建并执行为一个表新增外键约束的SQL语句. $name 参数指定外键名称. $table 和 $columns 参数指定表名和添加外键的列名. 如果有多个列, 它们必须由逗号分隔. $refTable和 $refColumns 参数指定了外键指向的表名和对应的列名.$delete 和 $update 参数分别指定SQL语句中的ON DELETE 和 ON UPDATE 操作. 大多数 DBMS 支持这些操作：RESTRICT, CASCADE, NO ACTION, SET DEFAULT, SET NULL. query builder 将会引用表名，索引名和列名

下面的例子展示了如何该表添加外键约束,

// ALTER TABLE `tbl_profile` ADD CONSTRAINT `fk_profile_user_id`
// FOREIGN KEY (`user_id`) REFERENCES `tbl_user` (`id`)
// ON DELETE CASCADE ON UPDATE CASCADE
addForeignKey('fk_profile_user_id', 'tbl_profile', 'user_id',
    'tbl_user', 'id', 'CASCADE', 'CASCADE')

dropForeignKey()

function dropForeignKey($name, $table)

dropForeignKey() 方法构建和执行删除外键约束的 SQL 语句. $name 参数指定了要删除的外键名. $table 参数指定了外键所在的表名. query builder 将会引用表名和合适的约束名.

下面的例子展示了如何删除外键约束:

// ALTER TABLE `tbl_profile` DROP FOREIGN KEY `fk_profile_user_id`
dropForeignKey('fk_profile_user_id', 'tbl_profile')

createIndex()

function createIndex($name, $table, $column, $unique=false)

createIndex() 方法构建并执行创建索引的 SQL语句. $name 参数指定了要创建的索引名称. $table 参数指定了创建索引的表名. $column 参数指定了被索引的列名. $unique参数指定了是否要创建unique索引. 如果索引包含多个列，按么必须通过逗号分隔. query builder 将会引用表名, 索引名和列名.

下面的例子展示了如何创建索引:

// CREATE INDEX `idx_username` ON `tbl_user` (`username`)
createIndex('idx_username', 'tbl_user', 'username')

dropIndex()

function dropIndex($name, $table)

dropIndex() 方法构建并执行了删除索引的 SQL 语句. $name 参数指定要删除的索引名. $table 参数指定了索引所在的表名. query builder 将会引用表名和合适的索引名.

下面的例子展示了如何删除索引:

// DROP INDEX `idx_username` ON `tbl_user`
dropIndex(&#39;idx_username&#39;, &#39;tbl_user&#39;)

以上就是Yii框架官方指南系列24——使用数据库：Query Builder的内容，更多相关内容请关注PHP中文网（www.php.cn）！

声明

この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。

11ベストPHP URLショートナースクリプト（無料およびプレミアム）Mar 03, 2025 am 10:49 AM

多くの場合、キーワードと追跡パラメーターで散らかった長いURLは、訪問者を阻止できます。 URL短縮スクリプトはソリューションを提供し、ソーシャルメディアやその他のプラットフォームに最適な簡潔なリンクを作成します。これらのスクリプトは、個々のWebサイトにとって価値があります

Instagram APIの紹介Mar 02, 2025 am 09:32 AM

2012年のFacebookによる有名な買収に続いて、Instagramはサードパーティの使用のために2セットのAPIを採用しました。これらはInstagramグラフAPIとInstagram Basic Display APIです。

Laravelでフラッシュセッションデータを使用しますMar 12, 2025 pm 05:08 PM

Laravelは、直感的なフラッシュメソッドを使用して、一時的なセッションデータの処理を簡素化します。これは、アプリケーション内に簡単なメッセージ、アラート、または通知を表示するのに最適です。データは、デフォルトで次の要求のためにのみ持続します。 $リクエスト -

LaravelのバックエンドでReactアプリを構築する：パート2、ReactMar 04, 2025 am 09:33 AM

これは、LaravelバックエンドとのReactアプリケーションの構築に関するシリーズの2番目と最終部分です。シリーズの最初の部分では、基本的な製品上場アプリケーションのためにLaravelを使用してRESTFUL APIを作成しました。このチュートリアルでは、開発者になります

Laravelテストでの簡略化されたHTTP応答のモッキングMar 12, 2025 pm 05:09 PM

Laravelは簡潔なHTTP応答シミュレーション構文を提供し、HTTP相互作用テストを簡素化します。このアプローチは、テストシミュレーションをより直感的にしながら、コード冗長性を大幅に削減します。基本的な実装は、さまざまな応答タイプのショートカットを提供します。 Illuminate \ support \ facades \ httpを使用します。 http :: fake（[[ 'google.com' => 'hello world'、 'github.com' => ['foo' => 'bar']、 'forge.laravel.com' =>