Laravel Yajra DataTable 如何合并两列不影响Eloquent搜索

核心思路 #

完全不动控制器中Eloquent查询的原有返回字段结构，不通过editColumn修改原字段的后端返回值，将列的合并展示逻辑下沉到前端DataTables层，配合yajra内置的独立搜索自定义能力实现完整功能，从根源上避免原editColumn写法导致的搜索报错问题。

具体实现步骤 #

1. 调整前端DataTables列配置 #

删除原配置中单独展示restaurant_city的独立列，将合并展示的逻辑写入restaurant_name列的渲染回调中，全程保留原字段的后端映射关系，不改动字段对应的SQL查询标识。
修改后的前端列配置代码：

columns: [
    {data: 'id', name: 'id', sClass: 'text-center'},
    {data: 'user_name', name: 'users.name', sClass: 'text-center'},
    // 合并后的餐厅信息列
    {
        data: 'restaurant_name',
        // 保留原餐厅名字段的后端搜索映射
        name: 'restaurants.name',
        sClass: 'text-center',
        // 前端直接拼接两个原有返回字段的内容，不修改后端返回结构
        render: function(data, type, row) {
            return row.restaurant_name + ' - ' + row.restaurant_city;
        },
        orderable: true,
        searchable: true
    },
    {data: 'action', name: 'action', sClass: 'text-center', orderable: false, searchable: false},
]

2. 补充控制器的独立搜索规则配置 #

不修改原有Eloquent查询的select、join、groupBy逻辑，仅通过yajra内置的filterColumn方法为合并列自定义搜索匹配范围，让搜索同时覆盖餐厅名称和城市两个字段。
修改后的控制器代码：

return DataTables::of(Order::GetAllOrders())
    ->addIndexColumn()
    // 为餐厅合并列独立配置搜索规则，完全不修改原有字段返回
    ->filterColumn('restaurant_name', function ($query, $keyword) {
        $query->where(function($subQuery) use ($keyword) {
            // 搜索范围同时覆盖餐厅名称、所属城市两个数据库字段
            $subQuery->where('restaurants.name', 'like', "%{$keyword}%")
                ->orWhere('restaurant_locations.city', 'like', "%{$keyword}%");
        });
    })
    ->editColumn('created_at', function ($data) {
        return date('d-m-Y', strtotime($data->updated_at));
    })
    ->addColumn('action', function($row){
        return view('admin.orders.all_orders.action-buttons', compact('row'))->render();
    })
    ->rawColumns(['action'])
    ->make(true);

方案特性说明 #

• 完全保留Eloquent查询返回的restaurant_name、restaurant_city原有字段，未新增合并后的独立返回列，符合需求约束
• 未使用editColumn修改restaurant_name的后端返回值，从根源上避免了字段值被篡改导致的列映射失效、SQL查询报错问题
• 搜索逻辑通过独立的filterColumn配置实现，和列展示逻辑完全解耦，不会和SQL查询的字段别名产生冲突
• 列的排序逻辑仍沿用原restaurant_name对应的数据库字段排序，不会因为前端合并展示影响原有排序功能

注意事项 #

• 前端配置中需要移除原独立展示restaurant_city的列，避免内容重复展示
• filterColumn中引用的数据库表名、字段名需要和查询中的join配置完全一致，避免触发SQL语法错误
• 如果开启了DataTables的前端正则搜索能力，需要为合并列关闭前端搜索拦截，避免前后端搜索逻辑重复触发

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