>[danger] 需 mix-database >= v2.0.2 才可使用。
## QueryBuilder
查詢生成器,能幫助 PDOConnection 生成 `select` 類型的語句,便于閱讀性與開發效率,能生成大部分常用業務的 SQL。
>[info] insert、batchInsert、update、delete 類型的 SQL 與其他更為復雜的 SQL 依然需使用 PDOConnection 開發。
| 類 | 調用 |
| --- | --- |
| Mix\Database\QueryBuilder | $db->table('table') |
## 獲取連接
- 同步模式
```
$db = app()->db;
```
- 協程模式
> 通過連接池組件獲取。
```
$db = app()->dbPool->getConnection();
$db->release(); // 不手動釋放的連接不會歸還連接池,會在析構時丟棄
```
## Result
任何 PDOConnection 連接對象的 table 方法,都可返回一個 QueryBuilder 實例。
```
// 返回全部
$ret = $db->table('users')->get();
// 返回第一行
$ret = $db->table('users')->first();
```
## Select
```
$ret = $db->table('users')->select('name', 'email as user_email')->get();
```
## 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();
```
```
// 二維 mix-database >= v2.0.4
$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();
// mix-database < v2.0.4 (在v2.1將只支持上面的用法)
$ret = $db->table('users')
->where(['id', 'between', 5, 10])
->get();
```
> NOT BETWEEN
```
// 最新用法
$ret = $db->table('users')
->where(['id', 'not between', [5, 10]])
->get();
// mix-database < v2.0.4 (在v2.1將只支持上面的用法)
$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();
~~~
- 歡迎使用 MixPHP
- 安裝說明
- 全量安裝
- Phar 命令行
- 入門須知
- 增改應用
- 命名空間
- 自動加載
- 入口文件
- 配置文件
- 服務開發
- 核心基礎
- Bean
- Component
- Application
- 命令行
- 簡介
- 命令行開發常識
- 命令行開發
- 創建命令
- 命令參數
- 打印與顏色
- 控制臺程序
- 守護程序
- HTTP 服務
- 簡介
- 服務器
- 路由
- 請求
- 響應
- 控制器
- 視圖
- Auth
- Session
- 文件上傳
- 其他組件
- 分頁
- 驗證碼
- 圖片處理
- 客戶端
- GuzzleHttp
- 雜項
- Apache/PHP-FPM部署
- 調試與錯誤
- 安全建議
- WebSocket 服務
- 簡介
- 服務器
- 注冊器
- 連接
- 客戶端
- 測試
- 雜項
- nginx代理
- 60s無消息斷線
- TCP 服務
- 簡介
- 服務器
- 客戶端
- 測試
- UDP 服務
- 簡介
- 服務器
- 客戶端
- 測試
- 協程
- 簡介
- 開啟協程
- PHP Stream Hook
- xgo + Channel
- WaitGroup + xdefer
- 連接池
- 協程池
- 定時器
- 公共組件
- 中間件
- 驗證器
- 驗證器定義
- 驗證規則
- 靜態調用
- 模型
- 日志
- 緩存
- 數據庫
- Database
- QueryBuilder
- PDOConnection
- Persistent\PDOConnection
- Coroutine\PDOConnection
- MasterSlave\PDOConnection
- ExecuteListener
- Redis
- RedisConnection
- Persistent\RedisConnection
- Coroutine\RedisConnection
- ExecuteListener
- 常見問題
- 同一臺服務器部署多個服務
- 連接多個數據庫
- 如何設置跨域
- form-data 上傳文件失敗
- 開發工具
- 版本更新
- 不兼容改動
- 升級指南
- 文檔歷史