[where]
where方法的參數支持字符串和數組,雖然也可以使用對象但并不建議。
-
字符串條件
使用字符串條件直接查詢和操作
$User = M("User"); // 實例化User對象
$User->where('type=1 AND status=1')->select();
如果使用3.1以上版本的話,使用字符串條件的時候,可以配合預處理機制,確保更加安全。
$Model->where("id=%d and username='%s' and xx='%f'",$id,$username,$xx)->select(); -
數組條件
普通查詢
$User = M("User"); // 實例化User對象
$map['name'] = 'thinkphp';
$map['status'] = 1;
$User->where($map)->select();
表達式查詢(EQ、NEQ、GT、EGT、LT、ELT、LIKE、BETWEEN、NOT BETWEEN、IN、NOT IN)
$map['字段1'] = array('表達式','查詢條件1');
$map['字段2'] = array('表達式','查詢條件2');
$Model->where($map)->select(); -
多次調用
3.1.3版本開始,where方法支持多次調用,但字符串條件只能出現一次。
$map['a'] = array('gt',1);
$where['b'] = 1;
$Model->where($map)->where($where)->where('status=1')->select();
[field]
field方法屬于模型的連貫操作方法之一,主要目的是標識要返回或者操作的字段,可以用于查詢和寫入操作。
-
用于查詢
field方法指定了查詢的結果集中包含id,title,content三個字段的值。
$Model->field('id,title,content')->select();
可以給某個字段設置別名。
$Model->field('id,nickname as name')->select();
可以在field方法中直接使用函數,例如sum函數。
$Model->field('id,SUM(score)')->select();
使用數組參數,執行效果和前面的一樣。
$Model->field(array('id','title','content'))->select();
數組方式的定義可以為某些字段定義別名。
$Model->field(array('id','nickname'=>'name'))->select(); -
字段排除
field可以帶true參數,表示排除第一個參數里面的字段。
獲取除了content之外的所有字段。
$Model->field('content',true)->select();
排除多個字段
$Model->field('user_id,content',true)->select();
$Model->field(array('user_id','content'),true)->select(); -
用于寫入合法性檢查
field方法結合create方法使用就可以完成表單提交的字段合法性檢測,多余數據會過濾掉。
$Model->field('title,email,content')->create();
[order]
支持對多個字段的排序,如果沒有指定desc或者asc排序規則的話,默認為asc。
$Model->where('status=1')->order('id desc,status')->limit(5)->select();
如果字段和mysql關鍵字有沖突,可以采用數組方式調用。
$Model->where('status=1')->order(array('order','id'=>'desc'))->limit(5)->select(); //排序字段為為order和id
[page]
雖然利用limit方法可以達到分頁效果,但是需要計算起始位置,page方法會自動計算。
$Article = M('Article');
$Article->page('1,10')->select(); // 查詢第一頁數據
$Article->page('2,10')->select(); // 查詢第二頁數據
3.1版本以后,page方法也支持2個參數的寫法。
$Article->page(1,10)->select();
page方法還可以和limit方法配合使用。
$Article->limit(25)->page(3)->select();
當page方法只有一個值傳入的時候,表示第幾頁,而limit方法則用于設置每頁顯示的數量,也就是說上面的寫法等同于:
$Article->page('3,25')->select();
[group]
group方法只有一個參數,并且只能使用字符串。
查詢結果按照用戶id進行分組統計。
$this->field('username,max(score)')->group('user_id')->select();
也支持對多個字段進行分組。
$this->field('username,max(score)')->group('user_id,test_time')->select();
注意:如果group之前不加任何函數操作的話,group之后,每一個分組只會返回第一條數據。
[having]
用于配合group方法完成從分組的結果中篩選。
having方法只有一個參數,并且只能使用字符串。
$this->field('username,max(score)')->group('user_id')->having('count(test_time)>3')->select();
[distinct]
返回唯一不同的值,distinct方法的參數是一個布爾值。
$Model->distinct(true)->field('name')->select();
[cache]
cache可以用于select、find和getField方法,以及其衍生方法。
對find方法使用cache方法,第一次查詢結果會被緩存,第二次查詢相同的數據的時候就會直接返回緩存中的內容,而不需要再次進行數據庫查詢操作。
$Model = M('User');
$Model->where('id=5')->cache(true)->find();
默認情況下, 緩存有效期和緩存類型是由DATA_CACHE_TIME和DATA_CACHE_TYPE配置參數決定的,但cache方法可以單獨指定。
$Model = M('User');
$Model->cache(true,60,'xcache')->find();
cache方法可以指定緩存標識。
$Model = M('User');
$Model->cache('key',60)->find();
外部可以通過S方法直接獲取查詢緩存的數據。
$Model = M('User');
$result = $Model->cache('key',60)->find();
$data = S('key');
[strict]
strict為3.2.3新增連貫操作,用于設置數據寫入和查詢是否嚴格檢查是否存在字段。默認情況下不合法數據字段自動刪除,如果設置了嚴格檢查則會拋出異常。
$model->strict(true)->add($data);
如果User表里面沒有test字段,執行如下語句就會報錯。
$Model = M('User');
$data['test'] = 'test';
$result = $Model->strict(true)->add($data);