
本文详细阐述了在codeigniter框架中,如何将从数据库获取的关联数组数据,高效地转换为满足特定前端或api需求的自定义json数组格式。通过具体的代码示例,我们将展示如何进行日期到unix时间戳(毫秒)的转换、字符串数字到浮点数的转换,并重塑数据结构,以确保json输出的精确性和可用性,从而优化前后端数据交互。
在构建Web应用程序时,后端API通常需要以特定格式响应数据,以满足前端组件(如图表库)或第三方服务的要求。一个常见场景是,数据库查询结果通常以关联数组(对象数组)的形式返回,而前端可能需要一个更紧凑、类型更精确的嵌套数组结构,例如包含时间戳和数值的二维数组。
理解数据转换需求
假设我们从CodeIgniter的模型中获取到如下格式的发票数据:
{
"price": [
{"date_issued":"2021-03-01","grand_total":"972.948"},
{"date_issued":"2021-03-12","grand_total":"1025.88"}
]
}然而,前端可能期望的数据格式是:
{
"price": [
[1483275269000, 972.948],
[1483361668000, 1025.88]
]
}可以看到,主要有以下几点转换需求:
- 数据类型转换:date_issued 字符串需要转换为 Unix 时间戳(通常是毫秒级),grand_total 字符串需要转换为浮点数。
- 结构重塑:原始的键值对对象需要转换为一个包含两个元素的数字索引数组。
- 嵌套结构:最终的 price 键对应的值是一个数组,其中每个元素又是一个数组。
实现数据转换的策略
为了实现上述转换,我们需要遍历从模型中获取的原始数据,对每一条记录的每个字段进行判断和处理。具体步骤如下:
- 获取原始数据:通过模型方法从数据库中检索数据。
- 初始化临时存储:创建一个空数组,用于存放转换后的数据。
- 外层遍历:遍历原始数据中的每一条记录(例如,每一张发票)。
- 内层遍历与条件判断:对于每条记录,遍历其所有字段。根据字段名(date_issued 或 grand_total)执行相应的类型转换。
- 构建新结构:将转换后的值按顺序添加到临时数组的当前子数组中。
- 封装与输出:将处理后的数据赋值给响应数组的指定键,并使用 json_encode 输出最终的JSON字符串。
CodeIgniter控制器中的实现示例
以下是在CodeIgniter控制器中实现此数据转换的示例代码:
load->model('invoice_model'); // 加载发票模型
}
public function getInvoicePrices() {
// 假设 logged('company_id') 用于获取当前用户的公司ID
// 实际应用中,您可能通过会话、JWT或其他认证方式获取用户ID
$company_id = logged('company_id');
// 从模型获取原始发票数据
// getAllData2 方法应返回一个包含发票信息的关联数组集合
$invoices = $this->invoice_model->getAllData2($company_id);
$temp_prices = []; // 初始化一个临时数组来存储转换后的价格数据
// 遍历每一张发票记录
foreach ($invoices as $index => $invoice_data) {
$current_price_entry = []; // 为当前发票初始化一个空的二维数组元素
// 遍历当前发票的所有字段
foreach ($invoice_data as $key => $value) {
switch ($key) {
case 'date_issued':
// 将日期字符串转换为Unix时间戳(秒),然后乘以1000得到毫秒
// 注意:strtotime() 失败会返回 false,需要考虑错误处理
$timestamp = strtotime($value);
if ($timestamp !== false) {
$current_price_entry[] = $timestamp * 1000;
} else {
// 处理日期转换失败的情况,例如记录日志或赋予默认值
$current_price_entry[] = null;
}
break;
case 'grand_total':
// 将总金额字符串转换为浮点数
$current_price_entry[] = floatval($value);
break;
default:
// 忽略其他不需要的字段
break;
}
}
// 只有当当前价格条目不为空时才添加到主数组中
if (!empty($current_price_entry)) {
$temp_prices[] = $current_price_entry;
}
}
// 构建最终的响应数组
$response['price'] = $temp_prices;
// 设置响应头为JSON
$this->output
->set_content_type('application/json')
->set_output(json_encode($response)); // 生产环境通常不使用 JSON_PRETTY_PRINT
}
}在上述代码中,我们使用了CodeIgniter的 output 类来设置响应内容类型并直接输出JSON,这是更推荐的做法,而不是简单的 echo json_encode(...)。
代码解析
$invoices = $this->invoice_model->getAllData2($company_id);: 这一行从模型中调用 getAllData2 方法,传入公司ID,以获取原始的发票数据。$invoices 预期是一个包含多个关联数组的数组,每个关联数组代表一张发票。
$temp_prices = [];: 初始化一个空数组 $temp_prices,它将用于存储最终转换后的 price 数组内容。
foreach ($invoices as $index => $invoice_data): 这是一个外层循环,遍历 $invoices 数组中的每一条发票记录。$invoice_data 在每次迭代中都是一个关联数组,例如 {"date_issued":"2021-03-01","grand_total":"972.948"}。
foreach ($invoice_data as $key => $value): 这是一个内层循环,遍历当前 $invoice_data 关联数组中的每个键值对。$key 是字段名(如 date_issued),$value 是对应的字段值。
-
switch ($key): 使用 switch 语句根据字段名 $key 来执行不同的处理逻辑。
- case 'date_issued':: 当字段名为 date_issued 时,strtotime($value) 将日期字符串转换为 Unix 时间戳(以秒为单位)。由于目标格式需要毫秒级时间戳,我们将其乘以 1000。 $current_price_entry[] = $timestamp * 1000; 将转换后的毫秒时间戳添加到当前发票的二维数组 $current_price_entry 中。 重要提示:strtotime() 在转换失败时会返回 false。在实际应用中,应加入错误处理逻辑,例如检查 $timestamp 是否为 false,或者在数据库层面确保日期格式的正确性。
- case 'grand_total':: 当字段名为 grand_total 时,floatval($value) 将字符串形式的总金额转换为浮点数。 $current_price_entry[] = floatval($value); 将转换后的浮点数添加到 $current_price_entry 中。
- default:: 对于其他不需要包含在最终输出中的字段,不做任何处理,直接跳过。
if (!empty($current_price_entry)) { $temp_prices[] = $current_price_entry; }: 在处理完一张发票的所有相关字段后,将构建好的 $current_price_entry (例如 [1483275269000, 972.948])添加到 $temp_prices 数组中。
$response['price'] = $temp_prices;: 将所有处理后的价格数据 $temp_prices 赋值给 $response 数组的 price 键。
$this->output->set_content_type('application/json')->set_output(json_encode($response));: 这是CodeIgniter中推荐的JSON输出方式。它首先设置HTTP响应的 Content-Type 头为 application/json,然后使用 json_encode 将 $response 数组转换为JSON字符串并作为响应体输出。在生产环境中,通常不需要 json_encode 的第二个参数 JSON_PRETTY_PRINT,因为它会增加响应大小。
注意事项与最佳实践
- 数据类型精确性:确保后端输出的数据类型与前端期望的严格匹配。例如,JavaScript处理毫秒时间戳和浮点数比处理字符串更高效和准确。
- 错误处理:对于 strtotime() 等可能失败的转换函数,务必加入错误处理逻辑。例如,当日期格式不正确时,可以返回 null、默认值或抛出异常。
- 性能考量:对于非常大的数据集,在PHP中进行大量的数据遍历和转换可能会消耗较多资源。如果可能,部分转换操作(如日期转时间戳)可以在SQL查询阶段完成,例如使用MySQL的 UNIX_TIMESTAMP() 函数。
- 模型职责:理想情况下,数据转换逻辑可以封装在模型层或一个专门的数据转换服务中,使控制器保持精简,只负责协调数据流。
- 可读性与维护性:保持代码结构清晰,使用有意义的变量名,并添加注释,以提高代码的可读性和未来的维护性。
总结
通过上述的数据转换策略和CodeIgniter实现示例,我们可以灵活地将数据库返回的原始数据重塑为满足特定API或前端需求的JSON格式。这种数据处理能力对于构建高效、可维护的Web应用程序至关重要,它确保了前后端之间数据交互的顺畅和准确性。理解并掌握这类数据转换技巧,将有助于您更好地应对各种复杂的数据呈现需求。










