如何无需临时表将自定义数据数组转为Illuminate\Database\Query\Builder

可以通过两种方式实现不依赖物理临时表，返回兼容Illuminate\Database\Eloquent\Builder的实例或具备同等功能的对象：

方法一：基于数据库虚拟表构造真实Builder #

利用数据库的VALUES语法（需MySQL 8.0+/PostgreSQL等支持）将API返回的数据构造为虚拟表，直接生成Eloquent Builder实例，完全兼容原有代码的所有查询方法：

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Support\Facades\DB;
use App\Models\Point;

final class CustomPoints
{
    public function index(): Builder
    {
        $response = Http::get('https://externalapi.com/points');
        $tempPoints = json_decode($response->getBody()->getContents(), true);

        // 映射API数据到Point模型的字段结构
        $pointsData = array_map(function ($item) {
            return [
                'name' => $item['title'],
                // 补充其他字段映射规则
            ];
        }, $tempPoints);

        // 处理空数据场景，返回空Builder
        if (empty($pointsData)) {
            return Point::whereRaw('1=0');
        }

        // 构造SQL VALUES子句，自动转义避免注入
        $values = implode(', ', array_map(function ($row) {
            $escapedValues = array_map(function ($value) {
                return DB::connection()->getPdo()->quote($value);
            }, $row);
            return '(' . implode(', ', $escapedValues) . ')';
        }, $pointsData));

        $columns = implode(', ', array_keys(reset($pointsData)));

        // 创建基于虚拟表的查询构造器
        $rawQuery = DB::query()->fromRaw("(VALUES $values) as points($columns)");

        // 绑定到Point模型的Eloquent Builder
        $builder = Point::query()->setQuery($rawQuery);

        // 应用分页参数
        return $builder->offset(($page - 1) * $defaultCount)->limit($defaultCount);
    }
}

优缺点：

• 优势：返回真实的Eloquent Builder，支持所有原生查询方法（where、orderBy、count等），无需修改调用方代码
• 局限：数据量过大时会生成超长SQL，可能触发数据库的SQL长度限制；依赖数据库对VALUES语法的支持

方法二：自定义集合构造器模拟Builder行为 #

如果数据量不大，可直接在内存中处理API数据，自定义一个类模拟Builder的核心方法，内部用Collection处理数据：

use Illuminate\Support\Collection;
use App\Models\Point;

class CollectionBuilder
{
    protected Collection $collection;
    protected int $offset = 0;
    protected ?int $limit = null;

    public function __construct(Collection $collection)
    {
        $this->collection = $collection;
    }

    // 实现offset方法
    public function offset(int $value): self
    {
        $this->offset = $value;
        return $this;
    }

    // 实现limit方法
    public function limit(int $value): self
    {
        $this->limit = $value;
        return $this;
    }

    // 实现orderBy方法（按需扩展）
    public function orderBy(string $column, string $direction = 'asc'): self
    {
        $this->collection = $this->collection->sortBy($column, SORT_REGULAR, strtolower($direction) === 'desc');
        return $this;
    }

    // 实现get方法，返回Point模型集合
    public function get(): Collection
    {
        $sliced = $this->collection->slice($this->offset, $this->limit);
        return $sliced->map(fn($item) => new Point($item));
    }

    // 按需扩展其他需要的Builder方法，比如count、first等
}

// 在CustomPoints类中使用
final class CustomPoints
{
    public function index(): CollectionBuilder
    {
        $response = Http::get('https://externalapi.com/points');
        $tempPoints = json_decode($response->getBody()->getContents(), true);

        $pointsData = array_map(function ($item) {
            return [
                'name' => $item['title'],
                // 补充其他字段映射
            ];
        }, $tempPoints);

        $collection = collect($pointsData);
        return (new CollectionBuilder($collection))
            ->offset(($page - 1) * $defaultCount)
            ->limit($defaultCount);
    }
}

优缺点：

• 优势：完全在内存处理，不依赖数据库，适合小数据量场景
• 局限：需自行实现所需的Builder方法，无法支持原生Builder的复杂查询（如join、whereHas等），若调用方严格要求返回Illuminate\Database\Eloquent\Builder类型则不适用

内容的提问来源于stack exchange，提问作者mstdmstd