## Mix\Database\QueryBuilder::class 查詢生成器，能幫助 Connection 生成 `select` 類型的語句，便于閱讀性與開發效率，能生成大部分常用業務的 SQL。 >[info] insert、batchInsert、update、delete 類型的 SQL 與其他更為復雜的 SQL 依然需使用 Connection 開發 ## Result 任何 Connection 連接對象的 table 方法，都可返回一個 QueryBuilder 實例。 ``` // 返回全部 $ret = $db->table('users')->get(); // 返回第一行 $ret = $db->table('users')->first(); ``` ## Select ``` // 常規 $ret = $db->table('users')->select('name', 'email as user_email')->get(); // 函數 $ret = $db->table('users')->select('count(*)')->first(); ``` ## Join 全部關聯方法有： - join - leftJoin - rightJoin - fullJoin ~~~ $ret = $db->table('users') ->join('orders', ['users.id', '=', 'orders.user_id']) ->select('users.*', 'orders.price') ->get(); ~~~ 多個關聯條件： > AND ``` ->join('orders', [['users.id', '=', 'orders.user_id'], ['users.name', '=', 'orders.user_name']]) // JOIN orders ON users.id = orders.user_id AND users.name = orders.user_name ``` > OR ``` ->join('orders', [['users.id', '=', 'orders.user_id'], ['or', ['users.name', '=', 'orders.user_name']]]) // JOIN orders ON users.id = orders.user_id OR users.name = orders.user_name ``` ## Where 只有一個 `where` 方法： ``` // 一緯 $ret = $db->table('users')->where(['id', '=', 1])->get(); ``` ``` // 二維 $ret = $db->table('users') ->where([['id', '=', 1], ['name', '=', "Xiao Liu"]]) ->get(); ``` 多個關聯條件： > AND ``` $ret = $db->table('users') ->where(['id', '=', 1]) ->where(['name', '=', 'Xiao Liu']) ->get(); ``` > OR ``` $ret = $db->table('users') ->where(['id', '=', 1]) ->where(['or', ['id', '=', 2]]) ->get(); ``` > OR AND ``` $ret = $db->table('users') ->where(['id', '=', 1]) ->where(['or', [['id', '=', 2], ['id', '=', 3]]]) ->get(); // WHERE id = 1 OR (id = 2 AND id = 3) ``` > AND OR ``` $ret = $db->table('users') ->where(['id', '=', 1]) ->where(['and', [['id', '=', 2], ['or', ['id', '=', 3]]]]) ->get(); // WHERE id = 1 AND (id = 2 OR id = 3) ``` ### In / NotIn > IN ``` $ret = $db->table('users') ->where(['id', 'in', [1, 2]]) ->get(); ``` > NOT IN ``` $ret = $db->table('users') ->where(['id', 'not in', [1, 2]]) ->get(); ``` ### Between / NotBetween > BETWEEN ``` // 最新用法 $ret = $db->table('users') ->where(['id', 'between', [5, 10]]) ->get(); ``` > NOT BETWEEN ``` // 最新用法 $ret = $db->table('users') ->where(['id', 'not between', [5, 10]]) ->get(); ``` ### Null / NotNull > IS NULL ~~~ $ret = $db->table('users') ->where(['id', 'is null']) ->get(); ~~~ > IS NOT NULL ~~~ $ret = $db->table('users') ->where(['id', 'is not null']) ->get(); ~~~ ## Order, Group, Limit, Offset ### orderBy 單個： ~~~ $ret = $db->table('users') ->orderBy('id', 'desc') ->get(); ~~~ 多個： ~~~ $ret = $db->table('users') ->orderBy('id', 'desc') ->orderBy('email', 'asc') ->get(); ~~~ ### groupBy / having 單個： ~~~ $ret = $db->table('orders') ->select('user_id', 'count(id) as counts') ->groupBy('user_id') ->having('count(id)', '>=', 1) ->get(); ~~~ 多個： ~~~ $ret = $db->table('orders') ->select('user_id', 'price', 'count(id) as counts') ->groupBy('user_id', 'price') ->having('count(id)', '>=', 1) ->get(); ~~~ ### limit / offset ~~~ $ret = $db->table('users') ->offset(10) ->limit(5) ->get(); ~~~