alexain/simple-spreadsheet-reader

A lightweight Symfony bundle to read spreadsheet-like files (CSV, XLSX) using a unified, streaming-friendly API.

v0.2.0 2025-12-18 22:16 UTC

Requires

• php: >=8.2
• openspout/openspout: ^4.0
• symfony/config: ^7.0|^8.0
• symfony/dependency-injection: ^7.0|^8.0
• symfony/http-kernel: ^7.0|^8.0
• symfony/yaml: ^7.0|^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.92
• phpoffice/phpspreadsheet: ^2.1
• phpunit/phpunit: ^10.5

MIT

• Alessandro Capano

README

SimpleSpreadsheetReader is a lightweight Symfony bundle that provides a unified and streaming-friendly API for reading tabular data from spreadsheet-like files such as CSV and XLSX.

The bundle is read-only by design and focuses on simplicity, performance, and low memory usage.
It is built for PHP 8.2+ and Symfony 7.x / 8.x, and is intended to standardize how Symfony applications consume spreadsheet data.

Its architecture is format-agnostic and intentionally extensible, allowing future support for additional formats such as OpenDocument (ODS).

Features

• Read-only spreadsheet parsing
• Supported formats:
  • CSV
  • XLSX
• Streaming-based reading (low memory footprint)
• Unified API across different formats
• Automatic format detection
• Header normalization and mapping
• Designed for large files
• Symfony-native services and configuration
• PHP 8.2+ compatible

Installation

composer require alexain/simple-spreadsheet-reader

If Symfony Flex is enabled, the bundle will be registered automatically.

Roadmap

Planned features and extensions:

• OpenDocument (ODS) support
• Custom row transformers
• Validation integration
• Import result reporting
• Strict vs lenient parsing modes

License

This bundle is released under the MIT License.

Contributing

Contributions are welcome. Please open an issue or submit a pull request for improvements or bug fixes.