
本文介绍一种轻量、可靠的方法,使用 PHP 将 cURL 获取的竖线(|)分隔的表格文本(含查询头和表头行)解析为标准 JSON 数组,支持字段自动映射与空行容错。
本文介绍一种轻量、可靠的方法,使用 php 将 curl 获取的竖线(`|`)分隔的表格文本(含查询头和表头行)解析为标准 json 数组,支持字段自动映射与空行容错。
在实际开发中,我们常通过 curl -X POST 调用数据库查询 API,返回格式却并非 JSON,而是类终端风格的竖线分隔表格(pipe-delimited table),例如:
> select ID, HEIGHT, COIN_BALANCE from account order by balance desc limit 20 ID | HEIGHT | COIN_BALANCE -7700097703553861699 | 1815934 | 299014795 ...
该输出包含三类行:① 查询语句行(以 > 开头)、② 表头行(字段名,用 | 分隔)、③ 数据行(同样以 | 分隔)。要将其转为规范 JSON 数组,关键在于:跳过首行、提取表头、逐行映射字段值、严格 trim 空格、健壮处理空行或异常行。
以下是一个生产就绪的 PHP 解析脚本(兼容 PHP 7.4+):
<?php // 模拟 cURL 输出(实际中可替换为 $output = shell_exec('curl -d "..." -X POST https://...');)
$output = <<<'EOT'
> select ID, HEIGHT, COIN_BALANCE from account order by balance desc limit 20
ID | HEIGHT | COIN_BALANCE
-7700097703553861699 | 1815934 | 299014795
-354651164223319404 | 1789433 | 150010434
514812057486191450 | 1815934 | 150000409
2819400133805325807 | 1789617 | 150000289
2045072049257519302 | 0 | 150000000
2825154884517497903 | 0 | 17904059
EOT;
// 步骤 1:按换行分割,过滤空行
$lines = array_filter(array_map('trim', explode("\n", $output)), 'strlen');
// 步骤 2:移除首行(查询语句)
array_shift($lines);
// 步骤 3:提取并清洗表头(第二行)
if (empty($lines)) {
die("Error: No data lines found after header.\n");
}
$headerLine = array_shift($lines);
$fieldNames = array_map('trim', explode('|', $headerLine));
// 步骤 4:逐行解析数据,构建关联数组
$result = [];
foreach ($lines as $line) {
if (!trim($line)) continue; // 跳过空行
$values = array_map('trim', explode('|', $line));
// 安全校验:字段数必须匹配,否则跳过该行(避免 json_encode 失败)
if (count($values) !== count($fieldNames)) {
error_log("Warning: Skipping malformed line — field count mismatch: " . $line);
continue;
}
$result[] = array_combine($fieldNames, $values);
}
// 步骤 5:输出格式化 JSON(含 UTF-8 支持)
header('Content-Type: application/json; charset=utf-8');
echo json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
✅ 关键设计说明:
- 使用
array_filter(..., 'strlen')自动剔除空行和纯空白行,增强鲁棒性; - 字段名与值均经
trim()处理,消除对齐空格干扰; - 添加字段数量校验,防止因格式错位导致
array_combine()报错; - 启用
JSON_UNESCAPED_UNICODE确保中文等 Unicode 字符正确输出; - 可无缝替换为真实 cURL 调用:
$output = shell_exec("curl -s -d 'sql=...' -X POST https://api.example.com/query");
⚠️ 注意事项:
- 若原始数据中字段值本身含
|(如日志文本),此方案不适用——需改用 CSV 解析器或服务端返回 JSON; - 生产环境建议增加 HTTP 状态码检查与超时控制,避免
shell_exec阻塞; - 如需 CLI 一键转换,可封装为脚本:
php parse_pipe.php | jq '.'(配合jq格式化或后续处理)。
该方法简洁、无外部依赖、逻辑清晰,是处理此类“非标准 API 响应”的高效实践方案。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











