在使用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号