찾다
php教程php手册yii Query Builder (yii 查询构造器) 官方指南翻译

yii Query Builder (yii 查询构造器) 官方指南翻译

Jun 13, 2016 am 10:19 AM
builderqueryyii장치공식적인가이드질문번역하다

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

 

성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.

핫 AI 도구

Undresser.AI Undress

Undresser.AI Undress

사실적인 누드 사진을 만들기 위한 AI 기반 앱

AI Clothes Remover

AI Clothes Remover

사진에서 옷을 제거하는 온라인 AI 도구입니다.

Undress AI Tool

Undress AI Tool

무료로 이미지를 벗다

Clothoff.io

Clothoff.io

AI 옷 제거제

Video Face Swap

Video Face Swap

완전히 무료인 AI 얼굴 교환 도구를 사용하여 모든 비디오의 얼굴을 쉽게 바꾸세요!

뜨거운 도구

SecList

SecList

SecLists는 최고의 보안 테스터의 동반자입니다. 보안 평가 시 자주 사용되는 다양한 유형의 목록을 한 곳에 모아 놓은 것입니다. SecLists는 보안 테스터에게 필요할 수 있는 모든 목록을 편리하게 제공하여 보안 테스트를 더욱 효율적이고 생산적으로 만드는 데 도움이 됩니다. 목록 유형에는 사용자 이름, 비밀번호, URL, 퍼징 페이로드, 민감한 데이터 패턴, 웹 셸 등이 포함됩니다. 테스터는 이 저장소를 새로운 테스트 시스템으로 간단히 가져올 수 있으며 필요한 모든 유형의 목록에 액세스할 수 있습니다.

mPDF

mPDF

mPDF는 UTF-8로 인코딩된 HTML에서 PDF 파일을 생성할 수 있는 PHP 라이브러리입니다. 원저자인 Ian Back은 자신의 웹 사이트에서 "즉시" PDF 파일을 출력하고 다양한 언어를 처리하기 위해 mPDF를 작성했습니다. HTML2FPDF와 같은 원본 스크립트보다 유니코드 글꼴을 사용할 때 속도가 느리고 더 큰 파일을 생성하지만 CSS 스타일 등을 지원하고 많은 개선 사항이 있습니다. RTL(아랍어, 히브리어), CJK(중국어, 일본어, 한국어)를 포함한 거의 모든 언어를 지원합니다. 중첩된 블록 수준 요소(예: P, DIV)를 지원합니다.

SublimeText3 Linux 새 버전

SublimeText3 Linux 새 버전

SublimeText3 Linux 최신 버전

메모장++7.3.1

메모장++7.3.1

사용하기 쉬운 무료 코드 편집기

DVWA

DVWA

DVWA(Damn Vulnerable Web App)는 매우 취약한 PHP/MySQL 웹 애플리케이션입니다. 주요 목표는 보안 전문가가 법적 환경에서 자신의 기술과 도구를 테스트하고, 웹 개발자가 웹 응용 프로그램 보안 프로세스를 더 잘 이해할 수 있도록 돕고, 교사/학생이 교실 환경 웹 응용 프로그램에서 가르치고 배울 수 있도록 돕는 것입니다. 보안. DVWA의 목표는 다양한 난이도의 간단하고 간단한 인터페이스를 통해 가장 일반적인 웹 취약점 중 일부를 연습하는 것입니다. 이 소프트웨어는