Skip to content
Read and write spreadsheet files (CSV, XLSX and ODS), in a fast and scalable way
PHP
Branch: master
Clone or download
Pull request Compare This branch is 14 commits behind box:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
src/Spout
tests
.editorconfig
.gitattributes
.gitignore
.php_cs.dist
.scrutinizer.yml
.travis.yml
CONTRIBUTING.md
LICENSE
README.md
UPGRADE-3.0.md
appveyor.yml
composer.json
logo.png
phpunit.xml

README.md

Spout

Latest Stable Version Project Status Build Status Scrutinizer Code Quality Code Coverage Total Downloads

Spout is a PHP library to read and write spreadsheet files (CSV, XLSX and ODS), in a fast and scalable way. Contrary to other file readers or writers, it is capable of processing very large files while keeping the memory usage really low (less than 3MB).

Join the community and come discuss about Spout: Gitter

Documentation

Full documentation can be found at http://opensource.box.com/spout/.

Requirements

  • PHP version 7.1 or higher
  • PHP extension php_zip enabled
  • PHP extension php_xmlreader enabled

Upgrade guide

Version 3 introduced new functionality but also some breaking changes. If you want to upgrade your Spout codebase from version 2 please consult the Upgrade guide.

Running tests

The master branch includes unit, functional and performance tests. If you just want to check that everything is working as expected, executing the unit and functional tests is enough.

  • phpunit - runs unit and functional tests
  • phpunit --group perf-tests - only runs the performance tests

For information, the performance tests take about 10 minutes to run (processing 1 million rows files is not a quick thing).

Performance tests status: Build Status

Support

You can ask questions, submit new features ideas or discuss about Spout in the chat room:
Gitter

Copyright and License

Copyright 2017 Box, Inc. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.