@@ -377,8 +377,9 @@ Db::query()->field(['id', 'name1 name', 'age1 as age']);
377377// 传入参数原样代入到SQL中
378378Db::query()->fieldRaw('id, name1 name, age1 as age');
379379
380- // 传入参数原样代入到SQL中,也支持参数绑定
380+ // 传入参数原样代入到SQL中,也支持参数绑定(不支持同时使用 ? 和 :xxx)
381381Db::query()->fieldRaw('id, name1 name, age1 as age, ? as value', null, [123]);
382+ Db::query()->fieldRaw('id, name1 name, age1 as age, :value as value', null, [':value' => 123]);
382383```
383384
384385### 条件 where
@@ -441,10 +442,12 @@ Db::query()->whereRaw('id >= 1');
441442Db::query()->whereRaw('id >= 1', 'or');
442443Db::query()->orWhereRaw('id >= 1');
443444
444- // 支持参数绑定
445+ // 支持参数绑定(不支持同时使用 ? 和 :xxx)
445446// 传入参数原样代入到SQL中,并且为or条件
446447Db::query()->whereRaw('id >= ?', 'or', [1]);
447448Db::query()->orWhereRaw('id >= ?', [1]);
449+ Db::query()->whereRaw('id >= :value', 'or', [':value' => 1]);
450+ Db::query()->orWhereRaw('id >= :value', [':value' => 1]);
448451```
449452
450453#### whereBrackets
@@ -531,9 +534,11 @@ Db::query()->table('tb_test1')->join('tb_test2', 'tb_test1.aid', '=', 'tb_test2.
531534// select * from tb_test1 left join tb_test2 on tb_test1.aid = tb_test2.bid
532535Db::query()->table('tb_test1')->joinRaw('left join tb_test2 on tb_test1.aid = tb_test2.bid');
533536
534- // 支持参数绑定
537+ // 支持参数绑定(不支持同时使用 ? 和 :xxx)
535538// select * from tb_test1 left join tb_test2 on tb_test1.aid = tb_test2.bid and tb_test2.xxx = ?
536539Db::query()->table('tb_test1')->joinRaw('left join tb_test2 on tb_test1.aid = tb_test2.bid and tb_test2.xxx = ?', [123]);
540+ // select * from tb_test1 left join tb_test2 on tb_test1.aid = tb_test2.bid and tb_test2.xxx = :value
541+ Db::query()->table('tb_test1')->joinRaw('left join tb_test2 on tb_test1.aid = tb_test2.bid and tb_test2.xxx = :value', [':value' => 123]);
537542
538543// 下面三种用法,第5个参数都支持传Where
539544// left join
@@ -556,6 +561,9 @@ Db::query()->orderRaw('id desc');
556561// order by id desc, 1 asc
557562Db::query()->orderRaw('id desc, ? asc', [1]);
558563
564+ // order by id desc, 1 asc
565+ Db::query()->orderRaw('id desc, :value asc', [':value' => 1]);
566+
559567// JSON 类型参数排序
560568Db::query()->order('field1->uid', 'desc');
561569```
@@ -570,7 +578,10 @@ Db::query()->group('id', 'name');
570578Db::query()->groupRaw('sum(id)');
571579
572580// group by sum(id), ?
573- Db::query()->groupRaw('sum(id), ?', 123);
581+ Db::query()->groupRaw('sum(id), ?', [123]);
582+
583+ // group by sum(id), :value
584+ Db::query()->groupRaw('sum(id), :value', [':value' => 123]);
574585```
575586
576587### having
0 commit comments