
本教程详细介绍了如何在 datatables 的服务器端处理中,通过 ssp (server-side processing) 类添加非数据库来源的计算列。文章将重点讲解 `formatter` 回调函数的使用,通过实际代码示例演示如何基于现有数据动态生成新列的值,从而实现更灵活的数据展示。
DataTables 是一个功能强大的 JavaScript 库,用于增强 HTML 表格的交互性。当处理大量数据时,服务器端处理(Server-side Processing)是必不可少的,它允许 DataTables 将数据检索、过滤、排序和分页等操作委托给服务器,从而减轻客户端的负担并提高性能。
在实际应用中,我们经常需要展示一些不直接存储在数据库中的列,这些列的值可能需要根据现有数据库字段进行计算、组合或格式化。例如,一个“评分”列可能需要根据“薪资”和“职位”等字段动态计算得出。本文将详细阐述如何在 DataTables 的服务器端处理中优雅地实现这类非数据库计算列。
DataTables 的 SSP (Server-side Processing) 类在处理 $columns 数组时提供了一个强大的 formatter 选项。这个 formatter 是一个回调函数,它允许开发者在数据发送到客户端之前,对每一列的每个单元格数据进行自定义处理。
formatter 函数接收两个关键参数:
通过利用 formatter 函数,我们可以完全控制列的输出内容,无论是简单的格式化、复杂的逻辑判断,还是基于其他列数据进行全新值的计算。
要添加一个非数据库来源的计算列,我们需要在服务器端的 PHP 脚本中,修改 $columns 数组的定义。
首先,回顾 DataTables 服务器端处理中 $columns 数组的基本结构。每个数组元素代表一个表格列,并至少包含 'db' (数据库列名) 和 'dt' (DataTables 列索引) 键。
<?php
// ... 其他配置,如 $table, $primaryKey, $sql_details ...
$columns = array(
array( 'db' => 'first_name', 'dt' => 0 ),
array( 'db' => 'last_name', 'dt' => 1 ),
array( 'db' => 'position', 'dt' => 2 ),
array( 'db' => 'office', 'dt' => 3 ),
array(
'db' => 'start_date',
'dt' => 4,
'formatter' => function( $d, $row ) {
return date( 'jS M y', strtotime($d));
}
),
array(
'db' => 'salary',
'dt' => 5,
'formatter' => function( $d, $row ) {
return '$'.number_format($d);
}
)
);
// ... SSP::simple 调用 ...
?>在上述示例中,start_date 和 salary 列已经使用了 formatter 进行格式化。我们将在此基础上添加一个全新的计算列。
为了添加一个名为“Rating”(评分)的计算列,我们需要在 $columns 数组中增加一个新的项。
对于非数据库来源的计算列,'db' 键的设置是一个关键点:
以下是添加“Rating”计算列的完整示例:
<?php
// 假设这是您的服务器端处理脚本 (e.g., ssp.class.php 所在目录的 index.php 或 data.php)
// 数据库连接详情
$sql_details = array(
'user' => 'your_db_user',
'pass' => 'your_db_password',
'db' => 'your_db_name',
'host' => 'localhost'
);
// 表名
$table = 'datatables_demo'; // 替换为您的实际表名
// 表的主键
$primaryKey = 'id';
// 定义 DataTables 列
$columns = array(
array( 'db' => 'id', 'dt' => 0 ), // 将 id 作为第一列,或任何您希望的列
array( 'db' => 'first_name', 'dt' => 1 ),
array( 'db' => 'last_name', 'dt' => 2 ),
array( 'db' => 'position', 'dt' => 3 ),
array( 'db' => 'office', 'dt' => 4 ),
array(
'db' => 'start_date',
'dt' => 5,
'formatter' => function( $d, $row ) {
return date( 'jS M y', strtotime($d));
}
),
array(
'db' => 'salary',
'dt' => 6,
'formatter' => function( $d, $row ) {
return '$'.number_format($d);
}
),
// 添加我们的新计算列:Rating
array(
'db' => 'id', // 使用 'id' 作为占位符,确保它会被 SQL 查询选中
'dt' => 7, // 新列在 DataTables 中的索引,确保与客户端匹配
'formatter' => function( $d, $row ) {
// 从 $row 数组中获取其他列的值进行计算
$salary = (int)$row['salary'];
$position = $row['position'];
$firstName = $row['first_name'];
// 执行您的自定义计算逻辑
$rating = 0;
// 基于薪资计算评分
if ($salary > 100000) {
$rating += 5;
} elseif ($salary > 50000) {
$rating += 3;
} else {
$rating += 1;
}
// 基于职位计算评分
if (strpos($position, 'Manager') !== false) {
$rating += 4;
} elseif (strpos($position, 'Developer') !== false) {
$rating += 2;
}
// 也可以基于其他字段,例如姓名的长度
if (strlen($firstName) > 5) {
$rating += 1;
}
// 返回计算出的评分
return $rating;
}
)
);
// 引入 SSP 类
require( 'ssp.class.php' ); // 确保路径正确
// 输出 JSON 响应
echo json_encode(
SSP::simple( $_GET, $sql_details, $table, $primaryKey, $columns )
);
?>在这个示例中,我们添加了一个索引为 7 的新列。它的 db 键被设置为 id,这意味着在服务器端查询时,id 列会被选中。然而,formatter 函数会完全忽略 id 的原始值 $d,而是利用 $row 数组中 salary、position 和 first_name 的值来计算并返回一个全新的“Rating”值。
在客户端的 JavaScript 中,您需要确保 DataTables 的 columns 配置与服务器端返回的列数和顺序相匹配。
$(document).ready(function() {
$('#example').DataTable({
'processing': true,
'serverSide': true,
'ajax': 'your_server_side_script.php', // 替换为您的服务器端脚本路径
'columns': [
{ 'data': 0 }, // id
{ 'data': 1 }, // first_name
{ 'data': 2 }, // last_name
{ 'data': 3 }, // position
{ 'data': 4 }, // office
{ 'data': 5 }, // start_date (formatted)
{ 'data': 6 }, // salary (formatted)
{ 'data': 7 } // Rating (calculated)
]
});
});通过 DataTables SSP 类的 formatter 回调函数,开发者可以灵活地在服务器端处理中添加非数据库来源的计算列。这一功能极大地增强了 DataTables 的数据展示能力,允许我们在不修改数据库结构的前提下,根据业务需求动态生成和展示复杂的数据。掌握 formatter 的使用,特别是如何利用 $row 参数进行跨列计算,是实现高效且功能丰富的 DataTables 应用的关键。
以上就是DataTables 服务器端处理:添加非数据库计算列的教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号