Laravel Eloquent 中获取查询构建器已选列的正确方式是什么

在Laravel的Eloquent查询构建操作中，我们有时会需要获取当前查询构建器已经设置的选中列，用于后续的查询逻辑处理或者调试。由于Laravel的查询构建器并没有对外暴露直接获取已选列的公共API，因此需要借助一些内部属性或者扩展方式来实现。

直接访问查询构建器内部属性

Laravel的查询构建器实例中，选中的列会存储在columns属性中，这个属性是受保护的，但是我们可以通过反射或者直接访问（在部分版本中属性访问权限有调整）来获取值。需要注意的是，这种方式依赖框架内部实现，框架版本升级时可能会有变动。

示例代码如下：

<?php
use AppModelsUser;
use ReflectionProperty;

// 创建查询构建器实例
$query = User::select(['id', 'name', 'email']);

// 使用反射获取受保护的columns属性
$reflection = new ReflectionProperty($query->getQuery(), 'columns');
$reflection->setAccessible(true);
$selectedColumns = $reflection->getValue($query->getQuery());

// 输出已选列
var_dump($selectedColumns);

通过闭包回调获取构建过程中的列

如果是在查询构建的过程中需要获取已选列，我们可以在调用select方法的时候通过闭包记录选中的列，这种方式不依赖框架内部属性，兼容性更好。

示例代码如下：

<?php
use AppModelsUser;

$selectedColumns = [];

$query = User::select(['id', 'name', 'email'])->when(true, function ($q) use (&$selectedColumns) {
    // 获取当前查询的columns属性
    $selectedColumns = $q->getQuery()->columns ?? ['*'];
});

var_dump($selectedColumns);

自定义扩展查询构建器

如果需要频繁获取已选列，推荐自定义扩展查询构建器，添加一个公共方法来获取已选列，避免重复编写反射代码，同时降低框架版本升级带来的影响。

首先创建自定义查询构建器类：

<?php
namespace AppExtensions;

use IlluminateDatabaseQueryBuilder as QueryBuilder;

class CustomQueryBuilder extends QueryBuilder
{
    /**
     * 获取当前查询已选列
     *
     * @return array
     */
    public function getSelectedColumns(): array
    {
        return $this->columns ?? ['*'];
    }
}

然后创建自定义的Eloquent模型基类，让所有模型继承这个基类：

<?php
namespace AppModels;

use AppExtensionsCustomQueryBuilder;
use IlluminateDatabaseEloquentModel;

abstract class BaseModel extends Model
{
    /**
     * 创建新的查询构建器实例
     *
     * @param IlluminateDatabaseQueryBuilder $query
     * @return IlluminateDatabaseEloquentBuilder|static
     */
    public function newEloquentBuilder($query)
    {
        return new IlluminateDatabaseEloquentBuilder(
            new CustomQueryBuilder(
                $query->getConnection(),
                $query->getGrammar(),
                $query->getProcessor()
            )
        );
    }
}

之后在业务模型中继承BaseModel，就可以直接调用getSelectedColumns方法：

<?php
namespace AppModels;

use AppModelsBaseModel;

class User extends BaseModel
{
    // 模型定义内容
}

// 使用方式
$query = User::select(['id', 'name']);
$columns = $query->getQuery()->getSelectedColumns();
var_dump($columns);

注意事项

• 直接访问内部属性的方式依赖框架实现，Laravel版本升级后可能会导致代码失效，不建议在生产环境大量使用。
• 如果没有调用select方法设置选中列，查询构建器的columns属性默认是null，此时默认会查询所有列，对应的值是['*']。
• 自定义扩展查询构建器的方式兼容性最好，适合需要频繁获取已选列的场景。

LaravelEloquent查询构建器已选列getColumns修改时间：2026-06-14 23:21:14