特別喜歡 ThinkPHP_3.2.3 框架的Model,結合官方手冊及查看源代碼,匯總出其大體用法:
核心轉換方法:
$this->parseWhere($where);
$whereStr .= $this->parseThinkWhere($key, $val);
$this->parseWhereItem($this->parseKey($key), $val);
// 內連接、左連接、右連接 UserModel.class.php
// SQL:( SELECT * FROM sg_user u LEFTJOIN sg_user_field uf on u.userId=uf.userId WHERE ( u.userId = 1 ) )
$list = $this->alias('u')->join('__USER_FIELD__ uf on u.userId=uf.userId', 'LEFT')->where($where)->buildSql();
$list = $this->table('__USER__u')->join('__USER_FIELD__ uf on u.userId=uf.userId', 'LEFT')->where($where)->buildSql();
單詞縮寫:
e(=):equal ; n:not ; gt(>):greater than ; lt(<):lower than
where查詢條件匯總:
<?php
$where = array(
'_logic' => 'and', 'or', 'xor',
array( // 注:跟 '_complex' 功能一樣
'name' => '名稱',
'title' => '標題'
),
'_complex' => array(
'name' => '名稱',
'title' => '標題'
),
'_string' => "name='52php.cnblogs.com' AND title='cnblogs'",
'_query' => "_logic=AND&name=52php.cnblogs.com&title=cnblogs",
//-------------------------------------------------
'name|title|nickname' => '名稱',
'name|title|nickname' => array(
'_multi' => 1,
'名稱',
'標題',
'昵稱'
),
'name&title&nickname' => '名稱',
'name&title&nickname' => array(
'_multi' => 1,
'名稱',
'標題',
'昵稱'
),
//-------------------------------------------------
'name' => '52php.cnblogs.com',
// 表達式查詢
'name' => array('like', '52php.cnblogs.com%'),
'name' => array('like', array('%52php.cnblogs.com%', '%sg'), 'or'),
'name' => array('notlike', '52php.cnblogs.com%'),
'name' => array('notlike', array('%52php.cnblogs.com%', '%sg'), 'or'),
'id' => array('eq|neq|gt|egt|lt|elt', 28),
'id' => array('exp', 'IN (2,3,4)'),
'id' => array('in|not in', '(2,3,4)', 'exp'),
'id' => array('in|not in', '2,3,4'),
'id' => array('in|not in', array(2,3,4)),
'id' => array('between', '1,8'),
'id' => array('between', array(1,8)),
// 區間查詢
'id' => array(array('neq', 6), array('gt', 3), 'and'),
'id' => array(array('neq', 6), array('gt', 3), array('and')),
'id' => array(array('exp', 'in(2,3,4)'), array('gt', 3), 'and'),
'id' => array(array('in', array(2,3,4)), array('eq', ''), 'or')
);
Where 條件中使用表達式
這里說的表達式,是指 ThinkPHP 框架中特有的表達式。這些表達式用於查詢或更新刪除等操作的 where條件 及模板標簽中。
Where 條件表達式格式為:
$where['字段名'] = array('表達式', '操作條件');
其中 $map 是一個普通的數組變量,可以根據自己需求而命名。上述格式中的表達式實際是運算符的意義:
ThinkPHP運算符 與 SQL運算符 對照表
| TP運算符 | SQL運算符 | 例子 | 實際查詢條件 |
|---|---|---|---|
| eq | = | $where['id'] = array('eq',100); | 等效於:$where['id'] = 100; |
| neq | != | $where['id'] = array('neq',100); | id != 100 |
| gt | > | $where['id'] = array('gt',100); | id > 100 |
| egt | >= | $where['id'] = array('egt',100); | id >= 100 |
| lt | < | $where['id'] = array('lt',100); | id < 100 |
| elt | <= | $where['id'] = array('elt',100); | id <= 100 |
| like | like | $where['username'] = array('like','Admin%'); | username like 'Admin%' |
| between | between and | $where['id'] = array('between','1,8'); | id BETWEEN 1 AND 8 |
| not between | not between and | $where['id'] = array('not between','1,8'); | id NOT BETWEEN 1 AND 8 |
| in | in | $where['id'] = array('in','1,5,8'); | id in(1,5,8) |
| not in | not in | $where['id'] = array('not in','1,5,8'); | id not in(1,5,8) |
| and(默認) | and | $where['id'] = array(array('gt',1),array('lt',10)); | (id > 1) AND (id < 10) |
| or | or | $where['id'] = array(array('gt',3),array('lt',10), 'or'); | (id > 3) OR (id < 10) |
| xor(異或) | xor | 兩個輸入中只有一個是true時,結果為true,否則為false,例子略。 | 1 xor 1 = 0 |
| exp | 綜合表達式 | $where['id'] = array('exp','in(1,3,8)'); | $where['id'] = array('in','1,3,8'); |
MySQL where條件表達式運算符參見:《MySQL WHERE 條件》。
補充說明
- 同 SQL 一樣,ThinkPHP運算符不區分大小寫,eq 與 EQ 一樣。
- between、 in 條件支持字符串或者數組,即下面兩種寫法是等效的:
$where['id'] = array('not in','1,5,8');
$where['id'] = array('not in',array('1','5','8'));
exp 表達式
上表中的 exp 不是一個運算符,而是一個綜合表達式以支持更復雜的條件設置。exp 的操作條件不會被當成字符串,可以使用任何 SQL 支持的語法,包括使用函數和字段名稱。
exp 不僅用於 where 條件,也可以用於數據更新,如:
$Dao = M("Article");
// 構建 save 的數據數組,文章點擊數+1
$data['aid'] = 10;
$data['counter'] = array('exp','counter+1');
// 根據條件保存修改的數據
$User->save($data);
