2016-08-14 06:09:15 +00:00
# PhpSpreadsheet - OpenXML - Read, Write and Create spreadsheet documents in PHP - Spreadsheet engine
Master:
[![Build Status ](https://travis-ci.org/PHPOffice/PhpSpreadsheet.svg?branch=master )](https://travis-ci.org/PHPOffice/PhpSpreadsheet)
[![Code Quality ](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/badges/quality-score.png?b=master )](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/?branch=master)
[![Code Coverage ](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/badges/coverage.png?b=master )](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/?branch=master)
[![Total Downloads ](https://poser.pugx.org/phpoffice/phpspreadsheet/downloads.png )](https://packagist.org/packages/phpoffice/phpspreadsheet)
[![Latest Stable Version ](https://poser.pugx.org/phpoffice/phpspreadsheet/v/stable.png )](https://packagist.org/packages/phpoffice/phpspreadsheet)
[![License ](https://poser.pugx.org/phpoffice/phpspreadsheet/license.png )](https://packagist.org/packages/phpoffice/phpspreadsheet)
2016-06-19 17:34:02 +00:00
[![Join the chat at https://gitter.im/PHPOffice/PhpSpreadsheet ](https://img.shields.io/badge/GITTER-join%20chat-green.svg )](https://gitter.im/PHPOffice/PhpSpreadsheet)
2015-05-26 20:36:46 +00:00
2016-08-14 06:09:15 +00:00
Develop:
[![Build Status ](https://travis-ci.org/PHPOffice/PhpSpreadsheet.png?branch=develop )](http://travis-ci.org/PHPOffice/PhpSpreadsheet)
[![Code Quality ](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/badges/quality-score.png?b=develop )](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/?branch=develop)
[![Code Coverage ](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/badges/coverage.png?b=develop )](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/?branch=develop)
2012-10-30 07:42:50 +00:00
2016-08-14 06:09:15 +00:00
PhpSpreadsheet is a library written in pure PHP and providing a set of classes that allow you to write to and read from different spreadsheet file formats, like Excel (BIFF) .xls, Excel 2007 (OfficeOpenXML) .xlsx, CSV, Libre/OpenOffice Calc .ods, Gnumeric, PDF, HTML, ... This project is built around Microsoft's OpenXML standard and PHP.
2012-10-30 07:42:50 +00:00
2016-08-14 06:09:15 +00:00
## File Formats supported
2012-10-30 07:42:50 +00:00
2016-08-14 06:09:15 +00:00
|Format |Reading|Writing|
|--------------------------------------------|:-----:|:-----:|
|Open Document Format/OASIS (.ods) | ✓ | ✓ |
|Office Open XML (.xlsx) Excel 2007 and above| ✓ | ✓ |
|BIFF 8 (.xls) Excel 97 and above | ✓ | ✓ |
|BIFF 5 (.xls) Excel 95 | ✓ | |
|SpreadsheetML (.xml) Excel 2003 | ✓ | |
|Gnumeric | ✓ | |
|HTML | ✓ | ✓ |
|SYLK | ✓ | |
|CSV | ✓ | ✓ |
|PDF (using either the tcPDF, DomPDF or mPDF libraries, which need to be installed separately)| | ✓ |
2012-10-30 07:42:50 +00:00
## Requirements
2016-06-19 17:34:02 +00:00
* PHP version 5.5.0 or higher
2016-08-14 06:09:15 +00:00
* PHP extension php_zip enabled (required if you need PhpSpreadsheet to handle .xlsx .ods or .gnumeric files)
2012-10-30 07:42:50 +00:00
* PHP extension php_xml enabled
* PHP extension php_gd2 enabled (optional, but required for exact column width autocalculation)
2016-08-14 22:28:23 +00:00
## PHP Version Support
* Support for PHP versions will only be maintained for a period of six months beyond the end-of-life of that PHP version
2012-10-30 07:42:50 +00:00
## Want to contribute?
2014-12-01 22:35:42 +00:00
If you would like to contribute, here are some notes and guidlines:
2016-08-14 22:28:23 +00:00
- All new development happens on feature/fix branches referenced with the github issue number, and are then merged to the develop branch; so the develop branch is always the most up-to-date, working code
2014-12-01 22:35:42 +00:00
- The master branch only contains tagged releases
2016-08-14 22:28:23 +00:00
- If you are going to be submitting a pull request, please fork from develop, and submit your pull request back as a fix/feature branch referencing the github issue number
2015-05-24 13:55:14 +00:00
- Wherever possible, code changes should conform to PSR-2 standards
- [Helpful article about forking ](https://help.github.com/articles/fork-a-repo/ "Forking a Github repository" )
- [Helpful article about pull requests ](https://help.github.com/articles/using-pull-requests/ "Pull Requests" )
2014-12-01 22:35:42 +00:00
2012-10-30 07:42:50 +00:00
## License
2016-08-14 06:09:15 +00:00
PhpSpreadsheet is licensed under [LGPL (GNU LESSER GENERAL PUBLIC LICENSE) ](https://github.com/PHPOffice/PhpSpreadsheet/blob/master/license.md )