PHP处理Parquet数据怎么读写

胖芳大大_2091

胖芳大大_2091

2026-09-28

522人浏览

原创

不能,php标准库和主流扩展均不支持原生读写parquet,需通过duckdb命令行、python pyarrow脚本或http api等外部工具间接实现。

php处理parquet数据怎么读写

PHP能直接读写Parquet吗?不能,得靠外部工具

PHP标准库和主流扩展(包括 ext-parquet)目前都不支持原生解析或生成 Parquet 文件。所谓“PHP处理Parquet”,本质是调用外部命令行工具(如 parquet-cli、duckdb、pyarrow 脚本)或通过 FFI / HTTP API 间接操作。硬要在 PHP 进程里做二进制解析,既没成熟库,也极易出错。

用 duckdb 命令行快速读取 Parquet 到 PHP 数组

duckdb 是最轻量、兼容性最好的选择:单二进制、无需服务端、支持 SQL 查询 Parquet 文件。PHP 只需执行 shell 命令并解析 JSON 输出:

  • 确保系统已安装 duckdb(v0.10+),且在 $PATH 中
  • 用 duckdb 执行 SELECT * FROM 'data.parquet' LIMIT 100 并导出为 JSON:
duckdb data.parquet "SELECT * FROM read_parquet('data.parquet') LIMIT 100" -json

PHP 中调用示例:

$cmd = escapeshellcmd("duckdb data.parquet \"SELECT * FROM read_parquet('data.parquet') LIMIT 100\" -json");
$output = shell_exec($cmd);
$data = json_decode($output, true);
  • escapeshellcmd() 必须用,否则文件名含空格或单引号会崩
  • duckdb 默认把 NULL 字段转成 null,PHP json_decode() 能正确映射
  • 注意:大文件加 LIMIT 或分页(OFFSET + LIMIT),否则内存爆掉

用 Python + pyarrow 写 Parquet:PHP 调用脚本最稳

PHP 自己拼 Parquet 二进制格式几乎不可行;用 pyarrow 写是最可靠路径。不装 Python 环境?不行——这是当前唯一可信赖的写入方案。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • Python 脚本(write_parquet.py)接收 JSON 格式 stdin:
import sys
import json
import pyarrow as pa
import pyarrow.parquet as pq
<p>data = json.load(sys.stdin)
table = pa.Table.from_pydict(data)
pq.write_table(table, sys.argv[1])</p>

PHP 中调用:

$json = json_encode(['col_a' => [1, 2, 3], 'col_b' => ['x', 'y', 'z']]);
$cmd = escapeshellcmd("python3 write_parquet.py output.parquet");
$proc = proc_open($cmd, [
    ['pipe', 'r'], // stdin
    ['pipe', 'w'], // stdout
    ['pipe', 'w']  // stderr
], $pipes);
<p>if (is_resource($proc)) {
fwrite($pipes[0], $json);
fclose($pipes[0]);
$stderr = stream_get_contents($pipes[2]);
fclose($pipes[2]);
proc_close($proc);
if (!empty($stderr)) {
throw new RuntimeException("pyarrow error: {$stderr}");
}
}</p>
  • 必须检查 $stderr,pyarrow 报错不会走 stdout,静默失败很常见
  • 字段类型由 pyarrow 自动推断,但字符串列含 null 时可能被误判为 large_string,后续读取兼容性一般没问题
  • 别用 exec() 直接传 JSON 参数——长度超限或特殊字符会截断

性能和线上部署要注意什么

这不是本地玩具方案。真实业务中,I/O 和进程开销是瓶颈,不是语法问题。

  • 每次读写都起新进程(duckdb 或 python),并发高时 CPU 和 fork 开销明显;考虑用常驻服务(如 FastAPI 封装 pyarrow 接口)替代 shell 调用
  • Parquet 文件路径必须对 PHP 进程可读(web server 用户如 www-data),权限错误时 shell_exec 返回空字符串,无报错提示
  • duckdb 对时间戳、嵌套结构(List/Struct)支持较好;但 PHP 传给 pyarrow 的数组不能含资源、对象、循环引用——json_encode() 会静默跳过

真正卡住人的从来不是“怎么写第一行代码”,而是权限、超时、stderr 没捕获、临时目录磁盘满、以及以为 JSON 就能直通 Parquet 类型系统。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php从入门到精通 php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9424

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5681

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2055

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3548

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4234

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3311

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4697

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3682

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11682

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
《20天入门精通PHP》视频教程
《20天入门精通PHP》视频教程

共200课时 | 47.9万人学习

墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习