jucai/libs/repositories/laravel-admin/docs/zh/model-grid-data.md

表格数据源

数据来自模型

如果使用模型来获取数据，那么修改来源数据就非常简单：

// 添加默认查询条件
$grid->model()->where('id', '>', 100);

// 设置初始排序条件
$grid->model()->orderBy('id', 'desc');

...

其它查询方法可以参考eloquent的查询方法.

数据来自外部API

如果数据是来自外部的API，需要展示在数据表格中那么可以建立model,然后覆盖掉模型的几个获取数据的方法来实现, 下面的例子用豆瓣电影的API获取并展示数据：

<?php

namespace App\Models\Movie;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Pagination\LengthAwarePaginator;
use Illuminate\Support\Facades\Request;

class InTheater extends Model
{
    public function paginate()
    {
        $perPage = Request::get('per_page', 10);

        $page = Request::get('page', 1);

        $start = ($page-1)*$perPage;

        $data = file_get_contents("https://api.douban.com/v2/movie/in_theaters?city=上海&start=$start&count=$perPage");

        $data = json_decode($data, true);

        extract($data);

        $movies = static::hydrate($subjects);

        $paginator = new LengthAwarePaginator($movies, $total, $perPage);

        $paginator->setPath(url()->current());

        return $paginator;
    }

    public static function with($relations)
    {
        return new static;
    }
}

通过覆盖模型的paginate和with方法获取API数据, 通过findOrFail方法来获取单项数据展示在表单中

同理如果要在form表单中获取或者保存数据那么也可以通过覆盖相应的方法来实现：

// 获取单项数据展示在form中
public function findOrFail($id)
{
    $data = file_get_contents("http://api.douban.com/v2/movie/subject/$id");

    $data = json_decode($data, true);

    return static::newFromBuilder($data);
}

// 保存提交的form数据
public function save(array $options = [])
{
    $attributes = $this->getAttributes();
    
    // save $attributes
}

数据来自复杂SQL查询

如果来源数据需要执行比较复杂的SQL语句获取，那么有两个办法, 第一个办法就是上面的方法，覆盖掉model的方法实现

public function paginate()
{
    $perPage = Request::get('per_page', 10);

    $page = Request::get('page', 1);

    $start = ($page-1)*$perPage;

    // 运行sql获取数据数组
    $sql = 'select * from ...';
    
    $result = DB::select($sql);
    
    $movies = static::hydrate($result);

    $paginator = new LengthAwarePaginator($movies, $total, $perPage);

    $paginator->setPath(url()->current());

    return $paginator;
}

public static function with($relations)
{
    return new static;
}

第二个方式是在数据库中建立视图和model绑定（未测试过，理论上可行）