
在使用laravel yajra datatables构建复杂数据列表时,开发者经常会遇到需要显示和排序关联模型数据的情况。然而,直接使用eloquent的with()方法进行关联加载,并尝试对关联字段进行排序或在自定义列(如操作列)中获取主表id时,可能会遇到“列未找到”的错误或id错乱的问题。
Laravel Eloquent的with()方法用于实现“预加载”(Eager Loading),它会执行额外的SQL查询来获取关联数据,然后将这些数据“注入”到主模型实例中。这种方式减少了N+1查询问题,但在Yajra DataTables的上下文环境中,它并没有将关联表直接JOIN到主查询中。因此,当DataTable尝试对一个未通过JOIN引入的关联列进行排序时,数据库会报告该列不存在,因为主查询中确实没有这个列。
同时,在action列等自定义列的回调函数中,如果DataTable的eloquent($query)方法没有明确指定选择主表的全部列(例如kabupaten.*),或者在query()方法中进行了隐式的列选择,可能导致传递给视图的$id变量指向关联表的ID而非主表的ID,造成数据操作混乱。
解决上述问题的关键在于,明确地在DataTable的query()方法中使用SQL JOIN语句将关联表连接进来,并为关联列设置一个唯一的别名,以便DataTable能够识别并对其进行排序。同时,确保明确选择主表的所有列,以避免ID混淆。
将KabupatenDataTable中的query()方法从使用with()改为使用leftJoin()。leftJoin确保即使没有匹配的关联数据,主表的数据也能被显示。通过addSelect()方法,我们明确地选择了kabupaten表的所有列(kabupaten.*),以及provinsi表的provinsi列,并为其指定了别名provinsi_provinsi。
<?php
namespace App\DataTables;
use App\Models\Kabupaten;
use Yajra\DataTables\Html\Button;
use Yajra\DataTables\Html\Column;
use Yajra\DataTables\Services\DataTable;
class KabupatenDataTable extends DataTable
{
/**
* Build DataTable class.
*
* @param mixed $query Results from query() method.
* @return \Yajra\DataTables\DataTableAbstract
*/
public function dataTable($query)
{
return datatables()
->eloquent($query)
->addIndexColumn()
->addColumn('kordinat', function(Kabupaten $kabupaten) {
// 这里的 $kabupaten 对象现在包含通过 JOIN 获取的 provinsi 属性
return $kabupaten->koordinat_bujur . "," . $kabupaten->koordinat_lintang;
})
->addColumn('action', 'kabupaten.action');
}
/**
* Get query source of dataTable.
*
* @param \App\Models\Kabupaten $model
* @return \Illuminate\Database\Eloquent\Builder
*/
public function query(Kabupaten $model)
{
// 使用 leftJoin 明确连接 provinsi 表
return Kabupaten::query()
->leftJoin('provinsi', 'provinsi.id', '=', 'kabupaten.provinsi_id')
->addSelect([
'kabupaten.*', // 确保选择 kabupaten 表的所有列,包括其 ID
'provinsi.provinsi as provinsi_provinsi' // 为关联列设置别名
]);
}
/**
* Optional method if you want to use html builder.
*
* @return \Yajra\DataTables\Html\Builder
*/
public function html()
{
return $this->builder()
->setTableId('kabupaten-table')
->columns($this->getColumns())
->minifiedAjax()
->dom('Bfrtip')
->orderBy(1) // 根据实际列顺序调整
->parameters([
'buttons' => ['excel'],
])
->buttons(
Button::make('create'),
Button::make('export'),
Button::make('print'),
Button::make('reset'),
Button::make('reload')
);
}
/**
* Get columns.
*
* @return array
*/
protected function getColumns()
{
return [
Column::make('DT_RowIndex')->title('No')->orderable(false)->searchable(false),
// 使用别名定义列,并设置 name 属性以支持排序
Column::make('provinsi_provinsi')->name('provinsi_provinsi')->title('Provinsi'),
Column::make('status'),
Column::make('kabupaten')->title('Nama kabupaten'),
Column::make('ketinggian'),
Column::make('kordinat')
->exportable(false)
->printable(false),
Column::computed('action')
->exportable(false)
->printable(false),
];
}
/**
* Get filename for export.
*
* @return string
*/
protected function filename()
{
return 'Kabupaten_' . date('YmdHis');
}
}在getColumns()方法中,将原来的Column::make('provinsi.provinsi')改为使用我们为关联列设置的别名,并通过name()方法明确指定用于排序的列名,这必须与addSelect中定义的别名一致。
// ... (在 KabupatenDataTable 类的 getColumns 方法中)
protected function getColumns()
{
return [
Column::make('DT_RowIndex')->title('No')->orderable(false)->searchable(false),
// 使用别名定义列,并设置 name 属性以支持排序
Column::make('provinsi_provinsi')->name('provinsi_provinsi')->title('Provinsi'),
Column::make('status'),
Column::make('kabupaten')->title('Nama kabupaten'),
Column::make('ketinggian'),
Column::make('kordinat')
->exportable(false)
->printable(false),
Column::computed('action')
->exportable(false)
->printable(false),
];
}由于我们在query()方法中使用了addSelect(['kabupaten.*', ...]),Yajra DataTables在处理每一行数据时,会优先使用主模型(Kabupaten)的属性。因此,在kabupaten.action视图中,$id变量将正确地指向kabupaten.id,而不是provinsi.id。
{{-- resources/views/kabupaten/action.blade.php --}}
<form id="delete_form" method="POST">
@csrf
@method('DELETE')
</form>
<a type="button" href="{{route('adm.kabupaten.show', ['id' => $id])}}" class="btn btn-just-icon btn-round btn-sm btn-info" data-toggle="tooltip" data-placement="bottom" title="detail">
<i class="fa fa-eye"></i>
</a>
<a href="{{route('adm.kabupaten.edit', ['id' => $id])}}" class="btn btn-just-icon btn-round btn-sm btn-primary" data-toggle="tooltip" data-placement="bottom" title="ubah">
<i class="fa fa-edit"></i>
</a>
<a href="#" data-url="{{ route('adm.kabupaten.destroy', $id) }}" class="btn btn-just-icon btn-round btn-sm btn-danger" onclick="return deleteConfirm(this);">
<i class="fa fa-trash"></i>
</a>
<script>
$(function() {
$('[data-toggle="tooltip"]').tooltip();
})
</script>在此视图中,$id将始终是kabupaten模型的ID。
通过上述方法,您可以有效地解决Laravel Yajra DataTables中关联列排序失效和ID获取不准确的问题,从而构建出功能完善且性能优越的数据表格。
以上就是Laravel Yajra DataTables 关系列排序与ID获取最佳实践的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号