https://github.com/workbunny/php-orc
🐇PHP library for reading and writing Apache ORC file format. It uses the swoole/phpy extension to call the Python module PyORC for implementation.
https://github.com/workbunny/php-orc
apache-orc php-orc swoole-phpy
Last synced: 12 months ago
JSON representation
🐇PHP library for reading and writing Apache ORC file format. It uses the swoole/phpy extension to call the Python module PyORC for implementation.
- Host: GitHub
- URL: https://github.com/workbunny/php-orc
- Owner: workbunny
- License: apache-2.0
- Created: 2024-08-21T08:19:48.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-25T06:50:36.000Z (about 1 year ago)
- Last Synced: 2025-06-03T10:58:25.830Z (about 1 year ago)
- Topics: apache-orc, php-orc, swoole-phpy
- Language: PHP
- Homepage:
- Size: 72.3 KB
- Stars: 13
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**
workbunny/php-orc
**
**
🐇 PHP library for reading and writing Apache ORC file format. It uses the swoole/phpy extension to call the Python module PyORC for implementation.
**
# 简介
- 通过`swoole/PHPy`内联调用`python/pyorc`实现对`Apache ORC`格式文件的读写
# 安装
- 安装composer包
```shell
composer require workbunny/php-orc
```
- 安装Python、pip、Python-dev
> 自行安装 或 通过`.vendor/bin/php-orc install:python`安装, `.vendor/bin/php-orc install:python --help`查看帮助
- 安装`PHPy`拓展
> 自行安装 或 通过`.vendor/bin/php-orc install:phpy`安装, `.vendor/bin/php-orc install:phpy --help`查看帮助
- 安装`pyorc`及依赖模块
> 自行安装 或 通过`.vendor/bin/php-orc install:pyorc`安装, `.vendor/bin/php-orc install:pyorc --help`查看帮助
# 使用
## 直接使用
通过`swoole/PHPy`创建`Reader`和`Writer`实例，使用PHP代理类代理调用
- 实例化`Reader`类进行读取操作，详细参考[examples/reader.php](https://github.com/workbunny/php-orc/blob/main/examples/reader.php)
- 实例化`Writer`类进行写入操作，详细参考[examples/writer.php](https://github.com/workbunny/php-orc/blob/main/examples/writer.php)
## 继承使用
通过`swoole/PHPy`创建`Reader`和`Writer`继承类，使用PHP类继承Python类，可直接调用/重写/拓展父类方法、参数
- 继承`ReaderClass`类进行读取操作的拓展开发或使用，详细参考[examples/readerClass.php](https://github.com/workbunny/php-orc/blob/main/examples/readerClass.php)
- 继承`WriterClass`类进行写入操作的拓展开发或使用，详细参考[examples/writerClass.php](https://github.com/workbunny/php-orc/blob/main/examples/writerClass.php)
# 说明
- 关于`Apache ORC`格式可以参考[Apache ORC](https://orc.apache.org/docs/)
- 关于`Python/PyORC`可以参考[Python/PyORC](https://github.com/apache/orc/tree/master/python)
- 建议使用`--venv`虚拟环境安装，在当前项目根目录中会创建`.venv`目录存放源码
- 关于使用上的代码问题，可以参考`swoole/PHPy`的文档[PHPy](https://github.com/swoole/phpy/blob/main/docs/cn/README.md)
- 使用本组件基于`Class`进行深度开发需要对`Python`及`PyORC`有一定了解
# 其他格式
- `Apache Parquet`
1. https://github.com/flow-php/parquet
2. https://github.com/codename-hub/php-parquet
- `Apache Iceberg`
- 暂无，后续`workbunny`会推出