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.