PHPackages                             workbunny/php-orc - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. workbunny/php-orc

ActiveLibrary[File & Storage](/categories/file-storage)

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.

0.1.5(1y ago)1582Apache-2.0PHPPHP >=8.1

Since Feb 26Pushed 1y agoCompare

[ Source](https://github.com/workbunny/php-orc)[ Packagist](https://packagist.org/packages/workbunny/php-orc)[ RSS](/packages/workbunny-php-orc/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (6)Versions (7)Used By (0)

[![workbunny](https://camo.githubusercontent.com/e2b1164338390ab45783434659e3e419e0c3b50fbe140c697ba1f82f59015ad6/68747470733a2f2f6368617a366368657a2e636e2f696d616765732f776f726b62756e6e792d6c6f676f2e706e67)](https://camo.githubusercontent.com/e2b1164338390ab45783434659e3e419e0c3b50fbe140c697ba1f82f59015ad6/68747470733a2f2f6368617a366368657a2e636e2f696d616765732f776f726b62756e6e792d6c6f676f2e706e67)

**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包

    ```
    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.
    2.
- `Apache Iceberg`
    - 暂无，后续`workbunny`会推出

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance45

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

6

Last Release

439d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d1b317277226c93c11984f73dfad75533893466b02d06611126aa1687209c6ab?d=identicon)[Chaz6Chez](/maintainers/Chaz6Chez)

---

Top Contributors

[![chaz6chez](https://avatars.githubusercontent.com/u/22535862?v=4)](https://github.com/chaz6chez "chaz6chez (32 commits)")[![Tinywan](https://avatars.githubusercontent.com/u/14959876?v=4)](https://github.com/Tinywan "Tinywan (1 commits)")

---

Tags

apache-orcphp-orcswoole-phpyphp-orcapache orcphpy

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/workbunny-php-orc/health.svg)

```
[![Health](https://phpackages.com/badges/workbunny-php-orc/health.svg)](https://phpackages.com/packages/workbunny-php-orc)
```

###  Alternatives

[vich/uploader-bundle

Ease file uploads attached to entities

1.9k25.9M116](/packages/vich-uploader-bundle)[vinelab/cdn

Content Delivery Network (CDN) Package for Laravel

217240.8k1](/packages/vinelab-cdn)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)