yii Query Builder （yii 查询构造器） 官方指南翻译

/****
Query Builder  

translated by php攻城师 

http://blog.csdn.net/phpgcs 

Preparing Query Builder             准备 Query Builder
Building Data Retrieval Queries     构建数据查找查询
Building Data Manipulation Queries  构建数据操作查询
Building Schema Manipulation Queries构建数据结构操作查询 

****/
Yii Query Builder 提供了一个以面向对象的方式写SQL表达式的方法。
允许开发者用 类的方法和属性来 明确一个SQL表达式中的独立的单元。然后将不同的单元组装成一个合法的SQL表达式，进而让DAO方法调用和执行。
下面是一个典型的使用Yii Query Builder来建立一个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语句时，或者基于一些额外的逻辑在你的应用中时， 用Yii Query Builder是最好不过的了。  

主要的好处是：  

1,  允许程序化建立一个复杂的SQL表达式
2， 自动引用表明和列名来 防止跟SQL保留关键字以及特殊字符的冲突
3， 在可以的情况下引用参数值，使用参数绑定，从而降低了SQL 注入攻击的风险。
4， 提供一定程度的DB抽象， 从而简化了向不同DB平台迁移的工作。  

并不是强制要使用 Query Builder， 事实上， 如果你的查询很简单，还是直接写SQL 语句来的快捷方便。  

注意： Query Builder 不可以被用语修改一个已经被定制了的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 和 Query Builder 混合使用！  

/***** 

1. Preparing Query Builder  

translated by php攻城师 

http://blog.csdn.net/phpgcs 

*****/  

Query Builder 是跟 CDbCommand 相关联的， 主 DB 查询类 定义在 DAO 中。
要开始使用 Query Builder， 我们创建一个 CDbCommand 实例如下：  

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

我们使用 Yii::app()->db 获得 DB connection, 然后用 CDbConnection::createCommand() 来创建实例.  

注意：这里我们不是想在DAO 中把一整个SQL语句给了 createCommand() ， 而是留空了。
这是因为我们将在后面使用  Query Builder 的方法来构建 这个SQL 表达式的不同部分。  

/***** 

2. Building Data Retrieval Queries  

translated by php攻城师 

http://blog.csdn.net/phpgcs 

*****/  

Data retrieval queries 指的是 SELECT SQL statements.   

query builder 提供了一系列方法来建立一个 SELCET 语句的不同部分。
因为所有这些方法返回了 CDbCommand 实例 ，我们可以通过使用 方法链来调用它们。如下：  

select(): specifies the SELECT part of the query
selectDistinct(): specifies the SELECT part of the query and turns on the DISTINCT flag
from(): specifies the FROM part of the query
where(): specifies the WHERE part of the query
andWhere(): appends condition to the WHERE part of the query with AND operator
orWhere(): appends condition to the WHERE part of the query with OR operator
join(): appends an inner join query fragment
leftJoin(): appends a left outer join query fragment
rightJoin(): appends a right outer join query fragment
crossJoin(): appends a cross join query fragment
naturalJoin(): appends a natural join query fragment
group(): specifies the GROUP BY part of the query
having(): specifies the HAVING part of the query
order(): specifies the ORDER BY part of the query
limit(): specifies the LIMIT part of the query
offset(): specifies the OFFSET part of the query
union(): appends a UNION query fragment
In the following, we explain how to use these query builder methods. For simplicity, we assume the underlying database is MySQL. Note that if you are using other DBMS, the table/column/value quoting shown in the examples may be different.  

select()
function select($columns='*')  

这个方法定制了查询的SELECT 部分。
参数 $columns 定制了将要被选择的列， 既可以是被逗号分隔开的列， 也可以是一个由列名构成的数组。
列名可以包含表前缀 和（或） 列别名。
这个方法将自动引用列名，除非某个列 包含了插入语（意味着那个列是由一个DB表达式提供）  

看例子：  

// 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'))  

from()
function from($tables)  

看例子：
// 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'))  

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

其中 $conditions 参数既可以是一个 (e.g. id=1) 也可以是一个如下格式的 array:  

array(operator, operand1, operand2, ...)
 operator 有以下几个:  

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).
    这个方法不会做任何的 quoting 或者 escaping.  

or: 类似 and  

in:  array('in', 'id', array(1,2,3)) =====> id IN (1,2,3). The method will properly quote the column name and escape values in the range.
not in:   

like: operand 1 ====> a column or DB expression
        operand 2 ====> a string or an array   

    array('like', 'name', '%tester%') =====> name LIKE '%tester%'
    array('like', 'name', array('%test%', '%sample%')) =====> name LIKE '%test%' AND name LIKE '%sample%'.   

The method will properly quote the column name and escape values in the range.
not like:
or like:
or not like:   

看例子：
// 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 时， 我们需要确定  % and _ .
如果来自用户的输入，我们还应该 使用如下的代码 来 过滤掉特殊字符 防止它们被当作通配符（wildcards）  

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

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

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

order()
function order($columns)  

看例子：  

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

limit() and offset()
function limit($limit, $offset=null)
function offset($offset)
注意，一些 DBMS 不支持 LIMIT and OFFSET ， 但是我们的 the Query Builder 将会重写整个SQL 语句来模拟 limit and offset.的功能。  

看例子：  

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

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

注意：不像其他的 query builder 方法， 每次调用 join 将会被添加到 之前的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 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 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 (select * from tbl_profile)
union('select * from tbl_profile')  

/*****
Executing Queries  执行查询
****/  

通过调用上面的 query builder 方法来构造 查询， 我们就可以用 DAO 方法来执行这个查询了。
例如：
$users = Yii::app()->db->createCommand()
    ->select('*')
    ->from('tbl_user')
    ->queryAll();  

/****
复原 SQLs
****/
 CDbCommand::getText().  

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

如果绑定有参数，我们也可以通过 CDbCommand::params property 来获得参数。  

其他语法 Building Queries  

有时候通过方法链来构建查询并不是最佳选择。
举例来说，下面的两个表达是等价的， 假设 $command 代表了一个CDbCommand 对象：  

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

进一步 CDbConnection::createCommand() 方法可以把 array 作为参数.   

如下：  

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

Building Multiple Queries 构建多查询  

一个 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. Building Data Manipulation Queries
translated by php攻城师 

http://blog.csdn.net/phpgcs 

*****/
数据操作 指的是 在一个 DB 表中 inserting, updating and deleting 数据。  

insert(): inserts a row into a table
update(): updates the data in a table
delete(): deletes the data from a table  

insert()
function insert($table, $columns)  

看例子：  

// 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())  

看例子：  

// 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())  

看例子：  

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

/******* 

4. Building Schema Manipulation Queries  

translated by php攻城师 

http://blog.csdn.net/phpgcs 

******/  

除了常规的查找查询和操作查询， 还有一系列的方法 来构建和执行 可以 操作 数据库结构的 SQL 查询。  

createTable(): creates a table
renameTable(): renames a table
dropTable(): drops a table
truncateTable(): truncates a table
addColumn(): adds a table column
renameColumn(): renames a table column
alterColumn(): alters a table column
addForeignKey(): adds a foreign key (available since 1.1.6)
dropForeignKey(): drops a foreign key (available since 1.1.6)
dropColumn(): drops a table column
createIndex(): creates an index
dropIndex(): drops an index  

Abstract Data Types  抽象数据类型  

实质上就是为了兼容不同的DBMS 而构建的数据类型， 一个通用的接口。  

pk: a generic primary key type, will be converted into int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY for MySQL;
string: string type, will be converted into varchar(255) for MySQL;
text: text type (long string), will be converted into text for MySQL;
integer: integer type, will be converted into int(11) for MySQL;
float: floating number type, will be converted into float for MySQL;
decimal: decimal number type, will be converted into decimal for MySQL;
datetime: datetime type, will be converted into datetime for MySQL;
timestamp: timestamp type, will be converted into timestamp for MySQL;
time: time type, will be converted into time for MySQL;
date: date type, will be converted into date for MySQL;
binary: binary data type, will be converted into blob for MySQL;
boolean: boolean type, will be converted into tinyint(1) for MySQL;
money: money/currency type, will be converted into decimal(19,4) for MySQL. This type has been available since version 1.1.8.  

createTable()
function createTable($table, $columns, $options=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)  

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

dropTable()
function dropTable($table)  

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

truncateTable()
function truncateTable($table)  

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

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

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

dropColumn()
function dropColumn($table, $column)  

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

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

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

alterColumn()  

// 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)  

// 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)
// 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)
// CREATE INDEX `idx_username` ON `tbl_user` (`username`)
createIndex('idx_username', 'tbl_user', 'username')  

dropIndex()
function dropIndex($name, $table)
// DROP INDEX `idx_username` ON `tbl_user`
dropIndex('idx_username', 'tbl_user')

以上是小编为您精心准备的的内容，在的博客、问答、公众号、人物、课程等栏目也有的相关内容，欢迎继续使用右上角搜索按钮进行搜索table
， function
， array
， id
， name
， The
， Yii联合查询
， leftJoin
， yii关联查询
， Yii查询
yii数据库查询
yii query builder、yii2 querybuilder、yii2 query、yii2 activequery、yii queryscalar，以便于您获取更多的相关知识。

时间： 2024-08-01 06:46:15

yii Query Builder （yii 查询构造器） 官方指南翻译的相关文章

Yii查询生成器(Query Builder)用法实例教程_php实例

本文为yii官网英文文档的翻译版本,主要介绍了Yii查询生成器(Query Builder)的用法.分享给大家供大家参考之用.具体如下: 首先,Yii的查询生成器提供了用面向对象的方式写SQL语句.它允许开发人员使用类的方法和属性来指定一个SQL语句的各个部分.然后,组装成一个有效的SQL语句,可以通过调用DAO数据访问对象的描述方法为进一步执行.以下显示了一个典型的使用查询生成器建立一个select语句: $user = Yii::app()->db->createCommand() -&g

PHP开发框架Yii Framework教程(25) 数据库-Query Builder示例

上一篇介绍PHP使用DAO(数据库访问对象接口)访问数据库的方法,使用DAO需要程序员编写SQL语句,对于一些复杂的SQL语 句,Yii提供了Query Builder来帮助程序员生成SQL语句,Query Builder提供了一中面向对象的方法动态创建SQL语句,打个不 十分恰当的比较,PHP 的DAO和.Net 的DAO接口非常类型,Query builder 就有点像LINQ了,尽管和LINQ比起来功能小很多.对 于一些简单的SQL查询,通常不需要借助于Query Builder,比如上篇

yii框架builder、update、delete使用方法_php实例

Yii自带的query builder还是很好用的,省去了拼sql的过程,今天在写一个语句的时候遇到这样一个问题 复制代码 代码如下: $connection = Yii::app()->db;$command = $connection->createCommand();$operate_rst = 0;if(!empty($_POST['lid'])){    $operate_rst = $command->update('emg_landing', $landing_info,

Yii2数据操作Query Builder详解

Query Builder $rows = (new \yii\db\Query()) ->select(['dyn_id', 'dyn_name']) ->from('zs_dynasty') ->where(['between','dyn_id', 1,30]) ->limit(10) ->all(); print_r($rows); 在CODE上查看代码片派生到我的代码片 use yii\db\Query; $query = (new Query()) ->fro

Spring Boot 整合 Elasticsearch，实现 function score query 权重分查询

摘要: 原创出处 www.bysocket.com 「泥瓦匠BYSocket 」欢迎转载,保留摘要,谢谢! 『 预见未来最好的方式就是亲手创造未来 – <史蒂夫·乔布斯传> 』 运行环境:JDK 7 或 8,Maven 3.0+技术栈:SpringBoot 1.5+,ElasticSearch 2.3.2 本文提纲 一.ES 的使用场景 二.运行 springboot-elasticsearch 工程 三.springboot-elasticsearch 工程代码详解 一.ES 的使用场景 简

ThinkPHP采用原生query实现关联查询left join实例_php实例

本文实例讲述了ThinkPHP采用原生query实现关联查询left join的方法.分享给大家供大家参考.具体如下: thinkphp提供了join方法来实现关联查询,但是很不好用,还是用原生的方便,所以推荐大家用query方法: 复制代码 代码如下: $Model = new Model();          $sql = "SELECT a.id, a.attr_name, a.attr_input_type, a.attr_type, a.attr_values, v.attr_val

Yii多表联合查询操作详解_php实例

本文针对Yii多表联查进行汇总描述,供大家参考,具体内容如下 1.多表联查实现方法 有两种方式一种使用DAO写SQL语句实现,这种实现理解起来相对轻松,只要保证SQL语句不写错就行了.缺点也很明显,比较零散,而且不符合YII的推荐框架,最重要的缺点在于容易写错. 还有一种便是下面要说的使用YII自带的CActiveRecord实现多表联查 2. 整体框架 我们需要找到一个用户的好友关系,用户的信息放在用户表中,用户之间的关系放在关系表中,而关系的内容则放在关系类型表中.明显的我们只需要以关系表为

ExtJS 4 官方指南翻译：Drag and Drop 拖放

原文:http://docs.sencha.com/ext-js/4-0/#!/guide/drag_and_drop 翻译:frank/sp42 转载请保留本页信息 拖放 Drag and Drop 在那么多的交互设计模式之中,"拖放(Drag andDrop)"模式可以说是开发者感觉比较不错的.用户日常在进行拖放操作的时候,真的是连"想都不用想"地就可以进行拖放操作了,非常直观而且易学易用.下文中的教程中,请跟随我们.不是我们"大厥其词",而

mysql dba系统学习（9）slow query log慢查询日志功能

慢查询日志(不包括获取锁的时间) 1,开启慢查询日志功能 以前的版本中开启慢查询日志功能的参数是--log_slow_queries在my.cnf文件中指定,但是现在新的版本中用参数--slow_query_log和--slow_query_log_file来指定 slow_query_log=1 slow_query_log_file=/tmp/mysqlslow.log 重新启动mysql mysql> show variables like "%slow%"; +-----