> 搜索器用于封裝查詢(xún)條件表達(dá)式，必須在模型中定義，只有使用模型操作數(shù)據(jù)時(shí)才能用搜索器。調(diào)用搜索器時(shí)使用的是數(shù)據(jù)表字段，可以不用定義搜索器方法，默認(rèn)是 = 條件；如果不是數(shù)據(jù)表字段，必須定義對(duì)應(yīng)的搜索器方法。 #### 1. 調(diào)用搜索器 --- **直接調(diào)用，默認(rèn)查詢(xún)條件是 `=`** ```php UserModel::withSearch(['name'], ['name' => '張三']) ->fetchSql(true) ->select(); ``` ``` SELECT * FROM `user` WHERE `name` = '張三' ``` **在模型中自定義搜索器方法，改變默認(rèn)的 `=`** ```php <?php namespace app\index\model; class User extends \think\Model { public function searchNameAttr($query, $value, $data) { $query->where('name','like', $value . '%'); } } ``` ```php UserModel::withSearch(['name'], ['name' => '張三']) ->fetchSql(true) ->select(); ``` ``` SELECT * FROM `user` WHERE `name` LIKE '張三%' ``` #### 2. 搜索器方法的三個(gè)參數(shù) `searchNameAttr($query, $value, $data)` --- + $query: `think\db\Query` 對(duì)象，用于鏈接操作 + $value：withSearch() 第二個(gè)參數(shù)中當(dāng)前搜索器字段對(duì)應(yīng)的值 + $data：withSearch() 第二個(gè)參數(shù)的值 可以直接在搜索器方法中打印參數(shù)，看看到底是個(gè)啥 ```php <?php namespace app\index\model; class User extends \think\Model { public function searchNameAttr($query, $value, $data) { halt($query, $value, $data); $query->where('name','like', $value . '%'); } } ```