Eloquent ORM 自定义 builder

Eloquent ORM 无疑是非常强大的，为开发者提供了许多好用的查询构造器。有时候，现有的查询构造器不能满足我们的要求时，我们也可以自定义。

模型层父类继承 Eloquent Model ，在构造方法中利用 macro 注册自定义的 builder。示例代码如下：

class Model extends \Illuminate\Database\Eloquent\Model
{
    public function __construct(array $attributes = [])
    {

        /**
         * 自定义 builder
         */

        /**
         * page() 方法
         * 参数： $page 页数 ；$limit 每页展示多少条
         * 使用方法：query链式调用
         */
        \Illuminate\Database\Query\Builder::macro('page', function ($page, $limit) {
            return $this->limit($limit)->offset(($page - 1) * $limit);
        });

        parent::__construct($attributes);
    }
}

Users 模型继承自 Model，在控制器中使用如下示例。

class UsersController extends Controller
{
    public function index()
    {
        // TODO:接收参数 $page 和 $limit

        $result = [
            'list' => Users::query()->with('XXX')->page($page, $limit)->get(),
            'total' => Users::select('id')->count(),
        ];

        return json(200, $result);
    }
}

finished!

PS：其实文中自定义的 page() ，与 Eloquent Model 中自带方法 perPage() 功能一致，所以自定义 page() 方法仅作示例使用。