使用宏(Macro)来扩展 Laravel 的数据库请求构建器

file

习惯了编写 SQL 语句的开发人员可能对 Laravel 的 ORM / Query Builder 并不是很了解。 当我们在需要用到查询构造器没有实现的方法时,通常会使用 select(DB::raw(...)) 来组装 SQL 表达式。

现在我们可以使用 Laravel 的 "Macros" 以更加灵活的方式来编写这些语句。 我将要执行的操作命名为 "insertOrUpdateMany" ,它将使用单个方法来构建和执行自定义 SQL 语句。

定义宏:#

为了保证代码的清晰可读性,我将绑定到宏的查询生成器实例和回调的参数 "$rows" 传递到一个新的宏实例。

use Illuminate\Database\Query\Builder;
use App\Macros\InsertOrUpdateMany;
Builder::macro('insertOrUpdateMany', function(array $rows){
    return with(new InsertOrUpdateMany($this, $rows))->execute();
});

我们可以将这些定义放在 Laravel 的服务提供者里。

使用 Macro#

我们的 Macro 功能类似于 Laravel 自带的 insert() 函数,返回结果是数据库影响的行数:

$affectedRowCount = DB::table('users')->insertOrUpdateMany(array(
    array(
        'id' => 1,
        'name' => 'Test 1',
        'email' => 'test1@test.local',
        'password' => 'XXX'
    ),
    array('id' => 2,
        'name' => 'Test 2',
        'email' => 'test2@test.local',
        'password' => 'XXX'
    ),
    array(
        'id' => 3,
        'name' => 'Test 3',
        'email' => 'test3@test.local',
        'password' => 'XXX'
    ),
));
dd($affectedRowCount);

数据库查询类#

数据库查询类 InsertOrUpdateMany 里将处理各种的 SQL 拼接和查询处理。类的构建函数里我们将获取到 Builder 和 PDO 连接,剩下的一切就变得很容易了,PDO 的 affectingStatement 直接就可返回数据库影响的行数。很容易吧,下面是完整的类代码:

InsertOrUpdateMany.php

代码已被折叠,点此展开
本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

原文地址:https://medium.com/@danielalvidrez/larav...

译文地址:https://learnku.com/laravel/t/15247/expa...

本帖已被设为精华帖!
本文为协同翻译文章,如您发现瑕疵请点击「改进」按钮提交优化建议
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
讨论数量: 3
liuqing_hu

Macro 的功能还是很有必要研究和学习的,不知道为什么都没人评论,希望更多人能够阅读这篇优秀的文章!强推,感谢译者!!

6年前 评论

Macro 主要靠 Closure 的 bindTo 方法实现的,laravel 作者确实牛逼

6年前 评论

有没有好一点的宏注册方式,使用服务提供者注册会存在每次请求都加载的情况

5年前 评论