Explication détaillée de l'utilisation de $map dans ThinkPHP

ThinkPHP dispose de méthodes de requête intégrées très flexibles, qui peuvent effectuer rapidement des opérations de requête de données. Les conditions de requête peuvent être utilisées pour n'importe quelle opération telle que CURD et peuvent être transmises en tant que paramètres de la méthode Where. du langage de requête un par un.

Méthode de requête

ThinkPHP peut prendre en charge l'utilisation directe de chaînes comme conditions de requête, mais dans la plupart cas Il est recommandé d'utiliser des tableaux d'index ou des objets comme conditions de requête car c'est plus sûr.
1. Utiliser des chaînes comme conditions de requête
C'est la manière la plus traditionnelle, mais elle n'est pas très sûre, par exemple :

$User = M("User"); // 实例化User对象
$User->where('type=1 AND status=1')->select();

La dernière généré L'instruction SQL est

SELECT * FROM think_user WHERE type=1 AND status=1

2. Utilisez des tableaux comme conditions de requête

$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();

L'instruction SQL finale générée est

SELECT * FROM think_user WHERE `name`='thinkphp' OR `account`='thinkphp'

3 Utilisez la méthode objet pour interroger (ici, prenez l'objet intégré stdClass comme. un exemple)

$User = M("User"); // 实例化User对象
 // 定义查询条件
$condition = new stdClass(); 
$condition->name = 'thinkphp'; 
$condition->status= 1; 
$User->where($condition)->select();

L'instruction SQL finale générée est la même que ci-dessus
SELECT * FROM think_user WHERE `name`='thinkphp' AND status=1
L'effet de l'utilisation d'une requête en mode objet et l'utilisation d'une requête tableau sont identiques et sont interchangeables. Dans la plupart des cas, nous recommandons d'utiliser la méthode tableau pour être plus efficace. Nous utiliserons plus tard la méthode tableau comme exemple pour expliquer l'utilisation spécifique du langage de requête.

Requête d'expression

La condition de requête ci-dessus n'est qu'un simple jugement d'égalité. Les expressions de requête peuvent être utilisées pour prendre en charge davantage de syntaxe de requête SQL et peuvent être utilisées pour des requêtes de tableau ou d'objet (ce qui suit. utilise uniquement la méthode array à titre d'exemple). Le format de l'expression de requête est :
$map['field name'] = array('expression','query condition');
Les expressions ne sont pas divisées en Upper et minuscules, les expressions de requête prises en charge sont les suivantes et leurs significations respectives sont :

表达式	含义
EQ	等于（=）
NEQ	不等于（a8093152e673feb7aba1828c43532094）
GT	大于（>）
EGT	大于等于（>=）
LT	小于（<）
ELT	小于等于（<=）
LIKE	模糊查询
[NOT] BETWEEN	（不在）区间查询
[NOT] IN	（不在）IN 查询
EXP	表达式查询，支持SQL语法

Les exemples sont les suivants :
EQ : égal à (=)
Par exemple :

$map['id'] = array('eq ',100);

est équivalent à la requête suivante

$map['id'] = 100;

La condition de requête représentée est id = 100

NEQ : Différent de (a8093152e673feb7aba1828c43532094)
Par exemple :

$map ['id'] = array('neq',100); La condition de requête représentée par

est id a8093152e673feb7aba1828c43532094 >GT
 : supérieur à (>)
Par exemple :
$map['id'] = array('gt',100);

requête représentée La condition est id > 100

EGT
 : supérieur ou égal à (>=)
Par exemple :
$map['id' ] = array('egt',100); La condition de requête représentée par

est id >= 100

LT
 : inférieur à (d12564180c0469b036b6d98f7fa83827'title|content'

, utilisez

$map['title'] = 'thinkphp';

La condition de requête deviendra un nom comme '%thinkphp%'Prend en charge le mode tableau, tel que

$map['a'] =array('like',array('%thinkphp%','%tp'),'OR');

$map['b'] =array('notlike',array('%thinkphp%','%tp'),'AND');

La condition de requête générée est : (un comme '%thinkphp%' OU un comme '%tp') ET (b pas comme '%thinkphp%' ET b pas comme '%tp')

[NON] BETWEEN
 : Identique à [not] between de SQL, les conditions de requête prennent en charge les chaînes ou les tableaux, par exemple :
$map['id'] = array('between',' 1, 8');

est équivalent à ce qui suit :

$map['id'] = array('between',array(' 1' ,'8'));

La condition de requête devient id BETWEEN 1 AND 8

[NOT] IN
 : Identique à SQL [not] dans , les conditions de requête prennent en charge les chaînes ou les tableaux, par exemple :
$map['id'] = array('not in','1,5,8');

est équivalent à ce qui suit :

$map['id'] = array('not in',array('1','5', ' 8'));

La condition de requête devient id NOT IN (1,5, 8)

EXP

 : Expression, prend en charge des situations de requête plus complexes
Par exemple :
$map['id'] = array('in','1,3,8');

peut être modifié Cheng :

$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

Requête dynamique

Avec les fonctionnalités du langage PHP5, ThinkPHP implémente des requêtes dynamiques, notamment les suivantes :

方法名	说明	举例
getBy	根据某个字段的值查询数据	例如，getByName,getByEmail
getFieldBy	根据某个字段查询并返回某个字段的值	例如，getFieldByName
top	获取前多少条记录（需要高级模型支持）	例如，top8，top12

一、getBy动态查询
该查询方式针对数据表的字段进行查询。例如，User对象拥有id,name,email,address 等属性，那么我们就可以使用下面的查询方法来直接根据某个属性来查询符合条件的记录。

$user = $User->getByName('liu21st');
$user = $User->getByEmail('liu21st@gmail.com');
$user = $User->getByAddress('中国深圳');

暂时不支持多数据字段的动态查询方法，请使用find方法和select方法进行查询。

二、getFieldBy动态查询
针对某个字段查询并返回某个字段的值，例如

$user = $User->getFieldByName('liu21st','id');

表示根据用户的name获取用户的id值。

三、top动态查询
ThinkPHP还提供了另外一种动态查询方式，就是获取符合条件的前N条记录（和定位查询一样，也要求当前模型类必须继承高级模型类后才能使用）。例如，我们需要获取当前用户中积分大于0，积分最高的前5位用户 ：

$User-> where('score>80')->order('score desc')->top5();

要获取积分的前8位可以改成：

$User-> where('score>80')->order('score desc')->top8();

子查询

新版新增了子查询支持，有两种使用方式：
1、使用select方法
当select方法的参数为false的时候，表示不进行查询只是返回构建SQL，例如：

// 首先构造子查询SQL 
$subQuery = $model->field('id,name')->table('tablename')->group('field')->where($where)->order('status')->select(false);

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可用于TP的连贯操作方法，例如table where等。

相关推荐：

详解ThinkPHP如何实现生成和校验验证码

thinkphp5上传图片及生成缩略图方法

详解ThinkPHP的行为扩展和插件

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!