这时，我们就需要转向 DataTables 的服务器端处理模式。这意味着每次用户进行搜索、排序或切换页面时，请求都会发送到服务器，由服务器查询数据库、处理数据，然后只返回当前页面所需的数据。这听起来很合理，但实际操作起来却是个不小的挑战：
- 解析请求参数： DataTables 会发送一系列复杂的 GET 或 POST 参数，你需要手动解析它们，理解用户的搜索词、排序字段和方向、当前页码和每页显示数量。
-
构建 Eloquent 查询： 根据这些参数，你需要动态地构建 Eloquent 查询，包括
where条件、orderBy子句、skip和take方法。 - 处理关联关系： 如果表格中包含关联模型的数据，你还需要考虑如何高效地加载它们，并支持对关联字段的搜索和排序。
- 格式化响应： 最后，你需要将查询结果格式化成 DataTables 期望的 JSON 结构，包括总记录数、过滤后的记录数以及当前页的数据。
手动实现这一切，不仅代码量庞大，而且极易出错，还浪费了大量宝贵的开发时间。
Composer在线学习地址：学习地址
救星驾到：freshbitsweb/laratables
正是为了解决这一痛点，freshbitsweb/laratables 这个 Composer 包应运而生。它是一个专门为 Laravel 设计的包，旨在简化 DataTables 服务器端 Ajax 请求的处理。通过它，你几乎可以不费吹灰之力地将 Eloquent 模型的数据呈现在 DataTables 中，同时自动支持搜索、排序和分页，并且提供了极高的定制性。
安装与配置
使用 Composer 安装 laratables 简单快捷：
composer require freshbitsweb/laratables
如果你需要修改默认配置，可以发布其配置文件：
php artisan vendor:publish --tag=laratables_config
如何使用：从问题到解决方案
laratables 的核心思想是让你在前端保持 DataTables 的标准配置，而在后端只需调用一个简单的方法即可处理所有服务器端逻辑。
1. 前端（Client-side）
在你的 Blade 模板或 JavaScript 文件中，DataTables 的配置与你平时使用服务器端模式时几乎一样：
$('#users-table').DataTable({
serverSide: true, // 开启服务器端模式
ajax: "{{ route('admin.users.datatables') }}", // 指定处理 Ajax 请求的路由
columns: [
{ name: 'id' },
{ name: 'name' },
{ name: 'email' },
{ name: 'role.name', orderable: false }, // 支持关联关系列，但通常不排序
{ name: 'action', orderable: false, searchable: false } // 自定义操作列
],
// ... 其他 DataTables 配置
});这里最关键的是 serverSide: true 和 ajax 配置，它告诉 DataTables 将数据请求发送到指定的 Laravel 路由。
2. 后端（Server-side）
现在，真正的魔法来了！在你的 Laravel 控制器中，处理这个路由的代码可以简化到令人难以置信：
use App\Models\User; // 假设你的用户模型在 App\Models 目录下
use Freshbitsweb\Laratables\Laratables;
class UserController extends Controller
{
public function datatables()
{
// 一行代码，搞定所有服务器端逻辑！
return Laratables::recordsOf(User::class);
}
}是不是觉得简直不可思议？一行代码就搞定了复杂的服务器端逻辑！laratables 会自动：
- 解析 DataTables 发送的所有请求参数。
- 根据模型构建 Eloquent 查询。
- 应用搜索条件（
LIKE运算符）。 - 应用排序规则。
- 处理分页。
- 将结果格式化为 DataTables 期望的 JSON 响应。
深入定制：满足复杂需求
然而，真实世界的应用往往比这复杂得多。你可能需要添加额外的查询条件、显示数据库中不存在的自定义列、或者对某些列的值进行格式化。laratables 的强大之处在于其灵活的定制能力。
你可以在你的 Eloquent 模型（或一个独立的自定义类）中定义一系列以 laratables 开头的方法，来控制数据的方方面面。
1. 控制查询条件 (laratablesQueryConditions)
如果你想对数据应用全局的查询条件，例如只显示活跃用户：
// App/Models/User.php
use Illuminate\Database\Eloquent\Builder;
class User extends Model
{
/**
* Fetch only active users in the datatables.
*
* @param \Illuminate\Database\Eloquent\Builder $query
* @return \Illuminate\Database\Eloquent\Builder
*/
public static function laratablesQueryConditions(Builder $query)
{
return $query->where('active', true);
}
}2. 自定义列 (laratablesCustom[ColumnName])
对于像“操作”列这种不直接存在于数据库中的列，你可以这样定义：
// App/Models/User.php
class User extends Model
{
/**
* Returns the action column html for datatables.
*
* @param \App\Models\User $user
* @return string
*/
public static function laratablesCustomAction(User $user)
{
return view('admin.users.includes.index_action', compact('user'))->render();
}
}这样，你就可以在 Blade 视图中渲染复杂的 HTML 按钮，而无需在前端拼接字符串。
3. 关联关系列与值格式化 (laratables[ColumnName])
laratables 默认支持显示关联模型的数据（如前端配置中的 role.name）。如果你想对某个列的值进行自定义格式化，例如限制用户名的长度：
// App/Models/User.php
use Illuminate\Support\Str;
class User extends Model
{
/**
* Returns truncated name for the datatables.
*
* @param \App\Models\User $user
* @return string
*/
public static function laratablesName(User $user)
{
return Str::limit($user->name, 15);
}
}你还可以为关联关系列定义特定的格式化方法，例如 laratablesRoleName()。
4. 自定义搜索与排序
laratables 甚至允许你完全控制某个列的搜索和排序逻辑。例如，如果你想让 name 列的搜索同时匹配 first_name 和 last_name：
// App/Models/User.php
use Illuminate\Database\Eloquent\Builder;
class User extends Model
{
/**
* Adds the condition for searching the name of the user in the query.
*
* @param \Illuminate\Database\Eloquent\Builder $query
* @param string $searchValue
* @return \Illuminate\Database\Eloquent\Builder
*/
public static function laratablesSearchName(Builder $query, string $searchValue)
{
return $query->orWhere('first_name', 'like', '%'. $searchValue. '%')
->orWhere('surname', 'like', '%'. $searchValue. '%');
}
}优势总结与实际应用效果
freshbitsweb/laratables 极大地提升了 Laravel 项目中 DataTables 的开发效率和可维护性：
- 开发效率倍增： 告别繁琐的参数解析和查询构建，将精力集中在业务逻辑上。
- 代码整洁： 将 DataTables 的服务器端逻辑封装在模型中，保持控制器简洁。
-
高度可定制： 丰富的
laratables*方法提供了细粒度的控制，满足各种复杂需求。 - 自动处理： 搜索、排序、分页、关联关系等复杂功能自动实现，减少了出错的可能性。
- 性能优化： 只返回必要的数据，确保前端 DataTables 在处理大量数据时依然流畅。
在实际项目中，我曾面临一个需要展示数万条用户日志的后台表格。手动实现服务器端逻辑不仅耗时，而且每次需求变更（如增加新的搜索条件或排序字段）都意味着大量代码的修改。引入 freshbitsweb/laratables 后，我仅仅通过在 Log 模型中添加几个 laratables* 方法，就轻松实现了所有功能，并且在后续维护中，代码的可读性和可扩展性都得到了显著提升。
重要提示
在享受 laratables 带来的便利时，有一个重要信息需要大家注意：该包目前已不再处于积极开发状态。 这意味着作者不再计划添加新功能。对于新项目或需要最新功能和长期支持的项目，你可能需要考虑维护一个 fork，或者寻找其他替代方案。然而，对于功能相对稳定、需求明确的项目，laratables 仍然是一个非常成熟且可靠的选择。
结语
freshbitsweb/laratables 是一个优雅而强大的 Laravel 包，它将 DataTables 服务器端处理的复杂性抽象化，让开发者能够以极简的方式实现高性能的数据展示。如果你还在为 DataTables 的服务器端逻辑而挣扎，不妨尝试一下 laratables，它一定会让你眼前一亮！
