PHPackages                             webnuvola/excel-reader - 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. [PDF & Document Generation](/categories/documents)
4. /
5. webnuvola/excel-reader

ActiveLibrary[PDF & Document Generation](/categories/documents)

webnuvola/excel-reader
======================

Read spreadsheet files (CSV, XLSX and ODS) using OpenSpout and return data in array format

v3.3.0(5mo ago)15.7k—10%MITPHPPHP ^8.3CI passing

Since Feb 19Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/Webnuvola/excel-reader)[ Packagist](https://packagist.org/packages/webnuvola/excel-reader)[ RSS](/packages/webnuvola-excel-reader/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (3)Versions (11)Used By (0)

Excel Reader
============

[](#excel-reader)

[![Latest Version on Packagist](https://camo.githubusercontent.com/4ef4773695ce1e3f6af0ed15db11b65ea0c9be5d4d592931afc8bdd7440e1f45/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7765626e75766f6c612f657863656c2d7265616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/webnuvola/excel-reader)[![GitHub Tests Action Status](https://camo.githubusercontent.com/2da937798a45f7cd6e40484af9230ef836fa7c6c9742c6e7c0be71a9b9f995e2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f5765626e75766f6c612f657863656c2d7265616465722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e)](https://github.com/webnuvola/excel-reader/actions?query=workflow%3ATests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/f0404169262301929de77ee1ff7b2e88e91b40d7c7d748da8a4361a6f6e423af/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7765626e75766f6c612f657863656c2d7265616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/webnuvola/excel-reader)

Read spreadsheet files (CSV, XLSX and ODS) using `openspout/openspout` and return data in array format.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require webnuvola/excel-reader
```

Usage
-----

[](#usage)

```
$excel = \Webnuvola\ExcelReader\ExcelReader::createFromPath(__DIR__.'/excel-file.xlsx')
    ->read();

$excel = \Webnuvola\ExcelReader\ExcelReader::createFromString($content, 'xlsx')
    ->read();
```

Testing
-------

[](#testing)

```
composer test
```

Upgrade Guide
-------------

[](#upgrade-guide)

### From `v2` to `v3`

[](#from-v2-to-v3)

This version drops support for php 7.4 and adds support for php 8.2.

The `openspout/openspout` library is updated to `^4.9`.

### From `v1` to `v2`

[](#from-v1-to-v2)

Library `box/spout` is replaced with `openspout/openspout`, there are no breaking changes.

If you are using `box/spout` outside this library, please refer to [`openspout/openspout` upgrade guide](https://github.com/openspout/openspout/#upgrade-from-boxspoutv3-to-openspoutopenspoutv3).

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Credits
-------

[](#credits)

- [Fabio Cagliero](https://github.com/fab120)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance72

Regular maintenance activity

Popularity24

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~198 days

Recently: every ~297 days

Total

10

Last Release

160d ago

Major Versions

v1.3.0 → v2.0.02022-10-11

v2.0.0 → v3.0.02022-12-13

PHP version history (7 changes)v1.0.0PHP ^7.4

v1.2.0PHP ^7.4|^8.0

v2.0.0PHP ~7.4.0 || ~8.0.0 || ~8.1.0

v3.0.0PHP ~8.0.0 || ~8.1.0 || ~8.2.0

v3.1.0PHP ^8.1

v3.2.0PHP ^8.2

v3.3.0PHP ^8.3

### Community

Maintainers

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

---

Top Contributors

[![fab120](https://avatars.githubusercontent.com/u/293368?v=4)](https://github.com/fab120 "fab120 (26 commits)")

---

Tags

csvexcelphpxlsxexcelxlsxlsxcsvspreadsheetodsPHPExcelphpspreadsheet

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/webnuvola-excel-reader/health.svg)

```
[![Health](https://phpackages.com/badges/webnuvola-excel-reader/health.svg)](https://phpackages.com/packages/webnuvola-excel-reader)
```

###  Alternatives

[phpoffice/phpspreadsheet

PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine

13.9k309.6M1.5k](/packages/phpoffice-phpspreadsheet)[rap2hpoutre/fast-excel

Fast Excel import/export for Laravel

2.3k26.3M50](/packages/rap2hpoutre-fast-excel)[openspout/openspout

PHP Library to read and write spreadsheet files (CSV, XLSX and ODS), in a fast and scalable way

1.2k65.5M209](/packages/openspout-openspout)[nuovo/spreadsheet-reader

Spreadsheet reader library for Excel, OpenOffice and structured text files

668883.3k8](/packages/nuovo-spreadsheet-reader)[avadim/fast-excel-reader

Lightweight and very fast XLSX Excel Spreadsheet and CSV Reader in PHP

106693.8k9](/packages/avadim-fast-excel-reader)[avadim/fast-excel-writer

Lightweight and very fast XLSX Excel Spreadsheet Writer in PHP

3021.3M9](/packages/avadim-fast-excel-writer)

PHPackages © 2026

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