ThinkPHP での $map の使用法の詳細な説明
- *文オリジナル
- 2018-01-03 11:06:264309ブラウズ
ThinkPHP には、データ クエリ操作を迅速に実行できる非常に柔軟なクエリ メソッドが組み込まれており、クエリ条件は CURD などのあらゆる操作に使用でき、where メソッドのパラメータとして渡すことができます。クエリ言語を 1 つずつ実行します。
Queryメソッド
ThinkPHPはクエリ条件として文字列の直接使用をサポートできますが、ほとんどの場合、より安全であるため、クエリ条件としてインデックス配列またはオブジェクトを使用することをお勧めします。
1. クエリ条件として文字列を使用します
これは最も伝統的な方法ですが、あまり安全ではありません。例:
$User = M("User"); // 实例化User对象
$User->where('type=1 AND status=1')->select();最后生成的SQL语句是
SELECT * FROM think_user WHERE type=1 AND status=1
二、使用数组作为查询条件
$User = M("User"); // 实例化User对象
$condition['name'] = 'thinkphp';
$condition['status'] = 1;
// 把查询条件传入查询方法
$User->where($condition)->select();
最后生成的SQL语句是SELECT * FROM think_user WHERE `name`='thinkphp' AND status=1如果进行多字段查询，那么字段之间的默认逻辑关系是 逻辑与 AND，但是用下面的规则可以更改默认的逻辑判断，通过使用 _logic 定义查询逻辑：
$User = M("User"); // 实例化User对象
$condition['name'] = 'thinkphp';
$condition['account'] = 'thinkphp';
$condition['_logic'] = 'OR';
// 把查询条件传入查询方法
$User->where($condition)->select();最后生成的SQL语句是
SELECT * FROM think_user WHERE `name`='thinkphp' OR `account`='thinkphp'
三、使用对象方式来查询 （这里以stdClass内置对象为例）
$User = M("User"); // 实例化User对象
// 定义查询条件
$condition = new stdClass();
$condition->name = 'thinkphp';
$condition->status= 1;
$User->where($condition)->select();最後に生成された SQL ステートメントは $User = M("User"); // 实例化User对象
// 要修改的数据对象属性赋值
$data['name'] = 'ThinkPHP';
$data['score'] = array('exp','score+1');// 用户的积分加1
$User->where('id=5')->save($data); // 根据条件保存修改的数据
2. クエリ条件として配列を使用します
$User = M("User"); // 实例化User对象
$map['status&title'] =array('1','thinkphp','_multi'=>true);
// 把查询条件传入查询方法
$User->where($map)->select(); |
3. オブジェクト メソッドを使用してクエリ | (ここでは、例として stdClass 組み込みオブジェクトを取り上げます)
|---|---|
| SELECT * FROM think_user WHERE `name`='thinkphp' AND status=1 | オブジェクト モード クエリを使用した場合と配列クエリを使用した場合の効果は同じであり、ほとんどの場合、互換性があります。使用することをお勧めします。配列メソッドの方が効率的です。後で、配列メソッドを例として使用して、クエリ言語の具体的な使用方法を説明します。式クエリ |
| $map['フィールド名'] = array('式','クエリ条件'); | 式は大文字と小文字を区別しません。サポートされているクエリ式は次のとおりです。それぞれの意味は次のとおりです。|
| 式 | の意味 |
| EQ | 等しい(=) |
| NEQ | 等しくない(a8093152e673feb7aba1828c43532094) |
| GT | より大きい (>) eegt |
| ltesless（＆lt;） | |
| ltelessolless or（＆lt; =） | |
| ファジークエリ | |
| (not) 間隔クエリ |
例は次のとおりです:
EQ: (=)に等しい
例:
$map['id'] = array('eq',100);
和下面的查询等效
$map['id'] = 100;
表示的查询条件就是 id = 100
NEQ： 不等于（a8093152e673feb7aba1828c43532094）
例如：
$map['id'] = array('neq',100);
表示的查询条件就是 id a8093152e673feb7aba1828c43532094 100
GT：大于（>）
例如：
$map['id'] = array('gt',100);
表示的查询条件就是 id > 100
EGT：大于等于（>=）
例如：
$map['id'] = array('egt',100);
表示的查询条件就是 id >= 100
LT：小于（2d538f6dfeb93821e0b5781f192d6848'title|content'
的话，使用
$map['title'] = 'thinkphp';
查询条件就会变成 name 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); // 根据条件保存修改的数据快捷查询
新版增加了快捷查询方式，可以进一步简化查询条件的写法，例如：
一、实现不同字段相同的查询条件
$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'
注意：快捷查询方式中“|”和“&”不能同时使用。
区间查询
ThinkPHP支持对某个字段的区间查询，例如：
$map['id'] = array(array('gt',1),array('lt',10)) ;
得到的查询条件是： (`id` > 1) AND (`id` bf31495c655a869adcf853bfc0674cdc 3) OR (`id` 5574d28fca4364415ca5b2761e781868 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')
组合查询
如果你需要在查询的时候同时偶尔使用字符串却又不希望丢失数组方式的灵活的话，可以考虑使用组合查询。
组合查询的主体还是采用数组方式查询，只是加入了一些特殊的查询支持，包括字符串模式查询（_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语句是一致的。
统计查询
在应用中我们经常会用到一些统计数据，例如当前所有（或者满足某些条件）的用户数、所有用户的最大积分、用户的平均成绩等等，ThinkPHP为这些统计操作提供了一系列的内置方法，包括：
| 方法 | 说明 |
|---|---|
| Count | 统计数量，参数是要统计的字段名（可选） |
| Max | 获取最大值，参数是要统计的字段名（必须） |
| Min | 获取最小值，参数是要统计的字段名（必须） |
| Avg | 获取平均值，参数是要统计的字段名（必须） |
| Sum | 获取总分，参数是要统计的字段名（必须） |
用法示例：
$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');
并且所有的统计查询均支持连贯操作的使用。
定位查询
ThinkPHP支持定位查询，但是要求当前模型必须继承高级模型类才能使用，可以使用getN方法直接返回查询结果中的某个位置的记录。例如：
获取符合条件的第3条记录：
$User->where('score>0')->order('score desc')->getN(2);
获取符合条件的最后第二条记录：
$User-> where('score>80')->order('score desc')->getN(-2);
获取第一条记录：
$User->where('score>80')->order('score desc')->first();
获取最后一条记录：
$User->where('score>80')->order('score desc')->last();
SQL查询
ThinkPHP内置的ORM和ActiveRecord模式实现了方便的数据存取操作，而且新版增加的连贯操作功能更是让这个数据操作更加清晰，但是ThinkPHP仍然保留了原生的SQL查询和执行操作支持，为了满足复杂查询的需要和一些特殊的数据操作，SQL查询的返回值因为是直接返回的Db类的查询结果，没有做任何的处理。主要包括下面两个方法：
1、query方法
| query 执行SQL查询操作 | |
|---|---|
| 用法 | query($sql,$parse=false) |
| 参数 | query（必须）：要查询的SQL语句 parse（可选）：是否需要解析SQL |
| 返回值 |
如果数据非法或者查询错误则返回false 否则返回查询结果数据集（同select方法） |
使用示例：
$Model = new Model() // 实例化一个model对象 没有对应任何数据表
$Model->query("select * from think_user where status=1");如果你当前采用了分布式数据库，并且设置了读写分离的话，query方法始终是在读服务器执行，因此query方法对应的都是读操作，而不管你的SQL语句是什么。
2、execute方法
| execute用于更新和写入数据的sql操作 | |
|---|---|
| 用法 | execute($sql,$parse=false) |
| 参数 | query（必须）：要执行的SQL语句 parse（可选）：是否需要解析SQL |
| 返回值 | 如果数据非法或者查询错误则返回false 否则返回影响的记录数 |
使用示例：
$Model = new Model() // 实例化一个model对象 没有对应任何数据表
$Model->execute("update think_user set name='thinkPHP' where status=1");如果你当前采用了分布式数据库，并且设置了读写分离的话，execute方法始终是在写服务器执行，因此execute方法对应的都是写操作，而不管你的SQL语句是什么。
3、其他技巧
自动获取当前表名
通常使用原生SQL需要手动加上当前要查询的表名，如果你的表名以后会变化的话，那么就需要修改每个原生SQL查询的sql语句了，针对这个情况，系统还提供了一个小的技巧来帮助解决这个问题。
例如：
$model = M("User");
$model->query('select * from __TABLE__ where status>1');我们这里使用了__TABLE__ 这样一个字符串，系统在解析的时候会自动替换成当前模型对应的表名，这样就可以做到即使模型对应的表名有所变化，仍然不用修改原生的sql语句。
支持连贯操作和SQL解析
新版对query和execute两个原生SQL操作方法增加第二个参数支持， 表示是否需要解析SQL （默认为false 表示直接执行sql ），如果设为true 则会解析SQL中的特殊字符串 （需要配合连贯操作）。
例如，支持 如下写法：
$model->table("think_user")
->where(array("name"=>"thinkphp"))
->field("id,name,email")
->query('select %FIELD% from %TABLE% %WHERE%',true);其中query方法中的%FIELD%、%TABLE%和%WHERE%字符串会自动替换为同名的连贯操作方法的解析结果SQL，支持的替换字符串包括：
| 替换字符串 | 对应连贯操作方法 |
|---|---|
| %FIELD% | field |
| %TABLE% | table |
| %DISTINCT% | distinct |
| %WHERE% | where |
| %JOIN% | join |
| %GROUP% | group |
| %HAVING% | having |
| %ORDER% | order |
| %LIMIT% | limit |
| %UNION% | union |
動的クエリ
PHP5 言語の機能を利用して、ThinkPHP は次のタイプを含む動的クエリを実装します。フィールドデータ
| getFieldBy | 特定のフィールドに基づいてクエリを実行し、特定のフィールドの値を返します | 例: getFieldByName |
|---|---|---|
| top | 最初のレコード数を取得(高度なモデルのサポートが必要です) | たとえば、top8、top12 |
以上がThinkPHP での $map の使用法の詳細な説明の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。