PHPackages                             avadim/fast-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. avadim/fast-excel-reader

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

avadim/fast-excel-reader
========================

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

v4.3.0(3w ago)105786.0k↓33.4%204MITPHPPHP >=7.4CI passing

Since Nov 19Pushed 3w ago4 watchersCompare

[ Source](https://github.com/aVadim483/fast-excel-reader)[ Packagist](https://packagist.org/packages/avadim/fast-excel-reader)[ Docs](https://github.com/aVadim483/fast-excel-reader)[ RSS](/packages/avadim-fast-excel-reader/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (8)Versions (85)Used By (4)

[![GitHub Release](https://camo.githubusercontent.com/4ae48d3dc8bfd7e1a52f2a6f2027efb67dbb3822c47ac87fc88b6f34aefa2918/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f61566164696d3438332f666173742d657863656c2d726561646572)](https://packagist.org/packages/avadim/fast-excel-reader)[![Packagist Downloads](https://camo.githubusercontent.com/23bc3c3b0b652ea39cc67c92649aad17a35a3b36700e98dab4a620da727fd248/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f61766164696d2f666173742d657863656c2d7265616465723f636f6c6f723d253233616130306161)](https://packagist.org/packages/avadim/fast-excel-reader)[![GitHub License](https://camo.githubusercontent.com/1e3aff13d4b3fb23bae1cd71a374d2b6b237aa5be88fba085ce53f6be3fb0239/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f61566164696d3438332f666173742d657863656c2d726561646572)](https://packagist.org/packages/avadim/fast-excel-reader)[![Static Badge](https://camo.githubusercontent.com/ec4898b6661c3fb76d8f5675d6e4162b05a524b1da30c719f4aaa7e15bc8d877/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344372e342d303035666337)](https://packagist.org/packages/avadim/fast-excel-reader)

FastExcelReader
===============

[](#fastexcelreader)

🇬🇧 English · [🇷🇺 Русский](README.ru.md)

**FastExcelReader** is a part of the FastExcelPhp Project which consists of

- [FastExcelWriter](https://packagist.org/packages/avadim/fast-excel-writer) - to create Excel spreadsheets
- [FastExcelReader](https://packagist.org/packages/avadim/fast-excel-reader) - to reader Excel spreadsheets and CSV-files
- [FastExcelTemplator](https://packagist.org/packages/avadim/fast-excel-templator) - to generate Excel spreadsheets from XLSX templates
- [FastExcelLaravel](https://packagist.org/packages/avadim/fast-excel-laravel) - special **Laravel** edition

Introduction
------------

[](#introduction)

This library is designed to be lightweight, super-fast and requires minimal memory usage.

**FastExcelReader** can read Excel compatible spreadsheets in XLSX format (Office 2007+), legacy XLS format (Office 97-2003) and CSV-files. It only reads data, but it does it very quickly and with minimal memory usage.

Features
--------

[](#features)

### XLSX format support

[](#xlsx-format-support)

- Supports XLSX format (Office 2007+) with multiple worksheets
- Supports autodetect currency/numeric/date types
- Supports auto formatter and custom formatter of datetime values
- The library can define and extract images from XLSX files
- The library can read styling options of cells - formatting patterns, colors, borders, fonts, etc.

### XLS format support

[](#xls-format-support)

- Supports legacy XLS format (Office 97-2003, BIFF8) with the same API as XLSX
- Values, dates, cell styles, formula text and images are all returned in the same shape
- The format is chosen by the file signature, not by the extension
- Streaming as well: a sheet is read in one forward pass with constant memory

### CSV format support

[](#csv-format-support)

- Openable via `Excel::open()` as a normal one-sheet workbook with the same reading API as XLSX/XLS, or via `Excel::openCsv()` for the low-level engine
- Delimiter Detection: Automatic detection or manual specification of column delimiters.
- Wide Encoding Support: Any encoding supported by your PHP environment
- Supports fields with or without quotes, and escaped quotes (doubled quotes).
- Multi-line Fields Handles line breaks within quoted fields.
- Two modes - strict (follows RFC 4180) and tolerant (with non-standard CSV files)

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

[](#installation)

Use `composer` to install **FastExcelReader** into your project:

```
composer require avadim/fast-excel-reader

```

Quick start
-----------

[](#quick-start)

```
use \avadim\FastExcelReader\Excel;

// XLSX, legacy XLS and CSV are all opened this way; the reader is chosen by the file signature
$excel = Excel::open(__DIR__ . '/files/demo.xlsx');

// Read all rows into a two-dimensional array (ROW x COL)
$rows = $excel->readRows();

// Or read row by row (memory efficient)
$sheet = $excel->sheet();
foreach ($sheet->nextRow() as $rowNum => $rowData) {
    // handle $rowData
}
```

See more in the [Getting Started](docs/10-getting-started.md) guide.

Documentation
-------------

[](#documentation)

### Guides

[](#guides)

- [Getting Started](docs/10-getting-started.md) — read cells, rows and columns
- [Reading Data](docs/11-reading-data.md) — row by row, array keys, empty cells & rows
- [Advanced Reading](docs/12-advanced-reading.md) — read areas, defined names, callbacks
- [Cell Value Types & Date Formatter](docs/13-dates-and-types.md)
- [Cell Styles](docs/14-cell-styles.md) — read complete style info of cells
- [Images](docs/15-images.md) — extract images from XLSX
- [Sheet Metadata](docs/16-sheet-metadata.md) — data validation, column widths, row heights, freeze pane, tab color, merged cells, dimensions
- [CSV Parsing](docs/20-csv.md) — reading CSV files
- [XLS (Excel 97-2003)](docs/21-xls.md) — reading legacy XLS workbooks

### API Reference

[](#api-reference)

- [API Reference](docs/90-api-reference.md)
    - [Class Excel](docs/91-api-class-excel.md)
    - [Class Sheet](docs/92-api-class-sheet.md)
    - [Class Csv\\CsvReader](docs/94-api-class-csv-reader.md)
    - [Class Csv\\CsvOptions](docs/95-api-class-csv-options.md)

### Examples

[](#examples)

You can find more examples in the [*/demo*](demo) folder.

### Changelog

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for the list of changes.

Do you want to support FastExcelReader?
---------------------------------------

[](#do-you-want-to-support-fastexcelreader)

if you find this package useful you can give me a star on GitHub.

Or you can donate me :)

- USDT (TRC20) TSsUFvJehQBJCKeYgNNR1cpswY6JZnbZK7
- USDT (ERC20) 0x5244519D65035aF868a010C2f68a086F473FC82b
- ETH 0x5244519D65035aF868a010C2f68a086F473FC82b

###  Health Score

66

—

FairBetter than 99% of packages

Maintenance95

Actively maintained with recent releases

Popularity55

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 94.4% 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 ~25 days

Recently: every ~1 days

Total

82

Last Release

22d ago

Major Versions

v1.4.2 → v2.0.02023-01-15

v2.30.0 → v3.0.02026-02-14

v3.2.0 → v4.0.02026-07-22

PHP version history (2 changes)v1.3.1PHP >=7.2

v2.0.0PHP >=7.4

### Community

Maintainers

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

---

Top Contributors

[![aVadim483](https://avatars.githubusercontent.com/u/2246758?v=4)](https://github.com/aVadim483 "aVadim483 (168 commits)")[![HergenD](https://avatars.githubusercontent.com/u/32772820?v=4)](https://github.com/HergenD "HergenD (5 commits)")[![MiMatus](https://avatars.githubusercontent.com/u/52460843?v=4)](https://github.com/MiMatus "MiMatus (2 commits)")[![BlackbitDevs](https://avatars.githubusercontent.com/u/8749138?v=4)](https://github.com/BlackbitDevs "BlackbitDevs (1 commits)")[![kaddy-dev](https://avatars.githubusercontent.com/u/190355182?v=4)](https://github.com/kaddy-dev "kaddy-dev (1 commits)")[![Kturva](https://avatars.githubusercontent.com/u/43371455?v=4)](https://github.com/Kturva "Kturva (1 commits)")

---

Tags

excelexcelparserexcelreaderimportparserphpphp-libraryreaderspreadsheetsxlsxphpparserlibraryexcelxlsxlsxcsvreaderspreadsheetimportPHPExcelMS Officeoffice 2007

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[avadim/fast-excel-writer

Lightweight and very fast XLSX Excel Spreadsheet Writer in PHP

3081.5M13](/packages/avadim-fast-excel-writer)[avadim/fast-excel-templator

Lightweight and very fast Excel Spreadsheet generator from XLSX-templates in PHP

21141.4k](/packages/avadim-fast-excel-templator)[openspout/openspout

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

1.2k75.4M295](/packages/openspout-openspout)[avadim/fast-excel-laravel

Lightweight and very fast XLSX Excel Spreadsheet Export/Import for Laravel

4263.3k1](/packages/avadim-fast-excel-laravel)[lekoala/spread-compat

Easily manipulate PhpSpreadsheet, OpenSpout and League CSV

1225.8k2](/packages/lekoala-spread-compat)[seine/seine

Seine - Write spreadsheets of various formats to a stream

1270.8k](/packages/seine-seine)

PHPackages © 2026

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