ThinkPHP のクエリ言語は、一貫した操作と組み合わせることで、複雑なビジネス ロジックの要件を効果的に解決できます。この記事では、まずフレームワークのクエリ言語について詳しく理解します。
1. クエリ言語の概要
ThinkPHP には、データ クエリ操作を迅速に実行できる非常に柔軟なクエリ メソッドが組み込まれており、クエリ条件は主に where メソッドなどの一貫した操作に使用できます。ほぼ同じクエリ メソッド (Mongo などの一部のデータベースには異なる式クエリがあります) を使用すると、システムは異なるデータベースの違いを解決するのに役立つため、フレームワークのこのクエリ メソッドをクエリ言語と呼びます。クエリ言語は、ThinkPHP フレームワークの ORM のハイライトでもあり、クエリ操作をよりシンプルかつ理解しやすくします。クエリ言語の意味を一つずつ説明しましょう。
2.お問い合わせ方法
ThinkPHP はクエリ条件として文字列の直接使用をサポートできますが、ほとんどの場合、より安全であるため、インデックス配列またはオブジェクトをクエリ条件として使用することをお勧めします。
1. クエリ条件として文字列を使用します
これは最も伝統的な方法ですが、あまり安全ではありません。例:
最終的に生成された SQL ステートメントは
文字列クエリを使用する場合、新しいバージョンで提供される文字列条件のセキュリティ前処理メカニズムを使用できますが、今は詳しく説明しません。
2. クエリ条件として配列を使用します
このメソッドは、最も一般的に使用されるクエリメソッドです。例:
最終的に生成された SQL ステートメントは
複数フィールドのクエリを実行する場合、フィールド間のデフォルトの論理関係は論理 AND ですが、_logic を使用してクエリ ロジックを定義することで、次のルールを使用してデフォルトの論理判断を変更できます。
リーリーリーリー
3. オブジェクトメソッドを使用してクエリを実行します
これは stdClass 組み込みオブジェクトの例です:リーリー
リーリー
3. 式クエリ
上記のクエリ条件は単純な等価性判定にすぎません。クエリ式は、ThinkPHP クエリ言語の本質でもある、より多くの SQL クエリ構文をサポートするために使用できます。リーリー
式では大文字と小文字が区別されません。サポートされているクエリ式は次のとおりです。それぞれの意味は次のとおりです。
表現 | 意味 |
---|---|
EQ | は(=) | に等しい
NEQ | は (<>) | と等しくありません
GT | (>)より大きい |
EGT | 以上 (>=) |
LT | (<)未満 |
エルト | 以下 (<=) |
いいね | あいまいクエリ |
[ない]間 | (not) 間隔クエリ |
[ない]入っています | (含まれていない)INクエリ |
経験値 | 式クエリ、SQL 構文をサポート |
EQ :等于(=)
例如:
$map['id'] = array('eq',100);
和下面的查询等效
$map['id'] = 100;
表示的查询条件就是 id = 100
NEQ: 不等于(<>)
例如:
$map['id'] = array('neq',100);
表示的查询条件就是 id <> 100
GT:大于(>)
例如:
$map['id'] = array('gt',100);
表示的查询条件就是 id > 100
EGT:大于等于(>=)
例如:
$map['id'] = array('egt',100);
表示的查询条件就是 id >= 100
LT:小于(<)
例如:
$map['id'] = array('lt',100);
表示的查询条件就是 id < 100
ELT: 小于等于(<=)
例如:
$map['id'] = array('elt',100);
表示的查询条件就是 id <= 100
[NOT] LIKE: 同sql的LIKE
例如:
$map['name'] = array('like','thinkphp%');
查询条件就变成 name like 'thinkphp%'
如果配置了DB_LIKE_FIELDS参数的话,某些字段也会自动进行模糊查询。例如设置了:
'DB_LIKE_FIELDS'=>'title|content'
的话,使用
$map['title'] = 'thinkphp';
查询条件就会变成 title like '%thinkphp%'
支持数组方式,例如
$map['a'] =array('like',array('%thinkphp%','%tp'),'OR'); $map['b'] =array('notlike',array('%thinkphp%','%tp'),'AND');
生成的查询条件就是:
(a like '%thinkphp%' OR a like '%tp') AND (b not like '%thinkphp%' AND b not like '%tp')
[NOT] BETWEEN :同sql的[not] between, 查询条件支持字符串或者数组,例如:
$map['id'] = array('between','1,8');
和下面的等效:
$map['id'] = array('between',array('1','8'));
查询条件就变成 id BETWEEN 1 AND 8
[NOT] IN: 同sql的[not] in ,查询条件支持字符串或者数组,例如:
$map['id'] = array('not in','1,5,8');
和下面的等效:
$map['id'] = array('not in',array('1','5','8'));
查询条件就变成 id NOT IN (1,5, 8)
EXP:表达式,支持更复杂的查询情况
例如:
$map['id'] = array('in','1,3,8');
可以改成:
$map['id'] = array('exp',' IN (1,3,8) ');
exp查询的条件不会被当成字符串,所以后面的查询条件可以使用任何SQL支持的语法,包括使用函数和字段名称。查询表达式不仅可用于查询条件,也可以用于数据更新,例如:
$User = M("User"); // 实例化User对象 // 要修改的数据对象属性赋值 $data['name'] = 'ThinkPHP'; $data['score'] = array('exp','score+1');// 用户的积分加1 $User->where('id=5')->save($data); // 根据条件保存修改的数据
4.快捷查询
从3.0版本开始,增加了快捷查询方式,可以进一步简化查询条件的写法,例如:
一、实现不同字段相同的查询条件
$User = M("User"); // 实例化User对象 $map['name|title'] = 'thinkphp'; // 把查询条件传入查询方法 $User->where($map)->select();
查询条件就变成
name= 'thinkphp' OR title = 'thinkphp'
二、实现不同字段不同的查询条件
$User = M("User"); // 实例化User对象 $map['status&title'] =array('1','thinkphp','_multi'=>true); // 把查询条件传入查询方法 $User->where($map)->select();
'_multi'=>true必须加在数组的最后,表示当前是多条件匹配,这样查询条件就变成
status= 1 AND title = 'thinkphp'
查询字段支持更多的,例如:
$map['status&score&title'] =array('1',array('gt','0'),'thinkphp','_multi'=>true);
查询条件就变成
status= 1 AND score >0 AND title = 'thinkphp'
注意:快捷查询方式中“|”和“&”不能同时使用。
5.区间查询
ThinkPHP支持对某个字段的区间查询,例如:
$map['id'] = array(array('gt',1),array('lt',10)) ;
得到的查询条件是:
(`id` > 1) AND (`id` < 10)
$map['id'] = array(array('gt',3),array('lt',10), 'or') ;
得到的查询条件是:
(`id` > 3) OR (`id` < 10)
$map['id'] = array(array('neq',6),array('gt',3),'and');
得到的查询条件是:(`id` != 6) AND (`id` > 3)
最后一个可以是AND、 OR或者 XOR运算符,如果不写,默认是AND运算。
区间查询的条件可以支持普通查询的所有表达式,也就是说类似LIKE、GT和EXP这样的表达式都可以支持。另外区间查询还可以支持更多的条件,只要是针对一个字段的条件都可以写到一起,例如:
$map['name'] = array(array('like','%a%'), array('like','%b%'), array('like','%c%'), 'ThinkPHP','or');
最后的查询条件是:
(`name` LIKE '%a%') OR (`name` LIKE '%b%') OR (`name` LIKE '%c%') OR (`name` = 'ThinkPHP')
6.组合查询
组合查询的主体还是采用数组方式查询,只是加入了一些特殊的查询支持,包括字符串模式查询(_string)、复合查询(_complex)、请求字符串查询(_query),混合查询中的特殊查询每次查询只能定义一个,由于采用数组的索引方式,索引相同的特殊查询会被覆盖。
一、字符串模式查询(采用_string 作为查询条件)
数组条件还可以和字符串条件混合使用,例如:
$User = M("User"); // 实例化User对象 $map['id'] = array('neq',1); $map['name'] = 'ok'; $map['_string'] = 'status=1 AND score>10'; $User->where($map)->select();
最后得到的查询条件就成了:
( `id` != 1 ) AND ( `name` = 'ok' ) AND ( status=1 AND score>10 )
二、请求字符串查询方式
请求字符串查询是一种类似于URL传参的方式,可以支持简单的条件相等判断。
$map['id'] = array('gt','100'); $map['_query'] = 'status=1&score=100&_logic=or';
得到的查询条件是:
`id`>100 AND (`status` = '1' OR `score` = '100')
三、复合查询
复合查询相当于封装了一个新的查询条件,然后并入原来的查询条件之中,所以可以完成比较复杂的查询条件组装。
例如:
$where['name'] = array('like', '%thinkphp%'); $where['title'] = array('like','%thinkphp%'); $where['_logic'] = 'or'; $map['_complex'] = $where; $map['id'] = array('gt',1);
查询条件是
( id > 1) AND ( ( name like '%thinkphp%') OR ( title like '%thinkphp%') )
复合查询使用了_complex作为子查询条件来定义,配合之前的查询方式,可以非常灵活的制定更加复杂的查询条件。
很多查询方式可以相互转换,例如上面的查询条件可以改成:
$where['id'] = array('gt',1); $where['_string'] = ' (name like "%thinkphp%") OR ( title like "%thinkphp") ';
最終的に生成された SQL ステートメントは一貫しています。
7. 統計クエリ
アプリケーションでは、現在のユーザー数 (または特定の条件を満たすユーザー)、全ユーザーの最大ポイント、ユーザーの平均スコアなどの統計データを使用することがよくあります。ThinkPHP は、一連の統計演算を提供します。これらの組み込みメソッドには以下が含まれます:
方法 | 手順 |
---|---|
カウント | 数量をカウントします。パラメータはカウントするフィールド名です(オプション) |
マックス | 最大値を取得します。パラメータはカウントするフィールド名です(必須) |
分 | 最小値を取得します。パラメータはカウントするフィールド名です(必須) |
平均 | 平均値を取得します。パラメータはカウントするフィールド名です(必須) |
合計 | 合計スコアを取得します。パラメータはカウントするフィールド名です(必須) |
用法示例:
$User = M("User"); // 实例化User对象
获取用户数:
$userCount = $User->count();
或者根据字段统计:
$userCount = $User->count("id");
获取用户的最大积分:
$maxScore = $User->max('score');
获取积分大于0的用户的最小积分:
$minScore = $User->where('score>0')->min('score');
获取用户的平均积分:
$avgScore = $User->avg('score');
统计用户的总成绩:
$sumScore = $User->sum('score');
并且所有的统计查询均支持连贯操作的使用。
8.SQL查询
ThinkPHP内置的ORM和ActiveRecord模式实现了方便的数据存取操作,而且新版增加的连贯操作功能更是让这个数据操作更加清晰,但是ThinkPHP仍然保留了原生的SQL查询和执行操作支持,为了满足复杂查询的需要和一些特殊的数据操作,SQL查询的返回值因为是直接返回的Db类的查询结果,没有做任何的处理。主要包括下面两个方法:
一、query方法
query 执行SQL查询操作 | |
---|---|
用法 | query($sql,$parse=false) |
参数 | sql(必须):要查询的SQL语句 parse(可选):是否需要解析SQL |
返回值 |
如果数据非法或者查询错误则返回false 否则返回查询结果数据集(同select方法) |
$Model = new Model() // 实例化一个model对象 没有对应任何数据表 $Model->query("select * from think_user where status=1");
如果你当前采用了分布式数据库,并且设置了读写分离的话,query方法始终是在读服务器执行,因此query方法对应的都是读操作,而不管你的SQL语句是什么。
二、execute方法
execute用于更新和写入数据的sql操作 | |
---|---|
用法 | execute($sql,$parse=false) |
参数 | sql(必须):要执行的SQL语句 parse(可选):是否需要解析SQL |
返回值 | 如果数据非法或者查询错误则返回false 否则返回影响的记录数 |
$Model = new Model() // 实例化一个model对象 没有对应任何数据表 $Model->execute("update think_user set name='thinkPHP' where status=1");
如果你当前采用了分布式数据库,并且设置了读写分离的话,execute方法始终是在写服务器执行,因此execute方法对应的都是写操作,而不管你的SQL语句是什么。
9.动态查询
借助PHP5语言的特性,ThinkPHP实现了动态查询,核心模型的动态查询方法包括下面几种:
方法名 | 说明 | 举例 |
---|---|---|
getBy | 根据字段的值查询数据 | 例如,getByName,getByEmail |
getFieldBy | 根据字段查询并返回某个字段的值 | 例如,getFieldByName |
$user = $User->getByName('liu21st'); $user = $User->getByEmail('liu21st@gmail.com'); $user = $User->getByAddress('中国深圳');
暂时不支持多数据字段的动态查询方法,请使用find方法和select方法进行查询。
二、getFieldBy动态查询
针对某个字段查询并返回某个字段的值,例如
$userId = $User->getFieldByName('liu21st','id');
表示根据用户的name获取用户的id值。
10.子查询
从3.0版本开始新增了子查询支持,有两种使用方式:
1、使用select方法
当select方法的参数为false的时候,表示不进行查询只是返回构建SQL,例如:
// 首先构造子查询SQL $subQuery = $model->field('id,name')->table('tablename')->group('field')->where($where)->order('status')->select(false);
当select方法传入false参数的时候,表示不执行当前查询,而只是生成查询SQL。
2、使用buildSql方法
$subQuery = $model->field('id,name')->table('tablename')->group('field')->where($where)->order('status')->buildSql();
调用buildSql方法后不会进行实际的查询操作,而只是生成该次查询的SQL语句(为了避免混淆,会在SQL两边加上括号),然后我们直接在后续的查询中直接调用。
// 利用子查询进行查询 $model->table($subQuery.' a')->where()->order()->select()
构造的子查询SQL可用于ThinkPHP的连贯操作方法,例如table where等。