PhpSpreadsheet/README.md

4.2 KiB

PhpSpreadsheet - OpenXML - Read, Write and Create spreadsheet documents in PHP - Spreadsheet engine

Master: Build Status Code Quality Code Coverage Total Downloads Latest Stable Version License Join the chat at https://gitter.im/PHPOffice/PhpSpreadsheet

Develop: Build Status Code Quality Code Coverage

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.

File Formats supported

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)

Requirements

  • PHP version 5.5.0 or higher
  • PHP extension php_zip enabled (required if you need PhpSpreadsheet to handle .xlsx .ods or .gnumeric files)
  • PHP extension php_xml enabled
  • PHP extension php_gd2 enabled (optional, but required for exact column width autocalculation)

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

Want to contribute?

If you would like to contribute, here are some notes and guidlines:

  • 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
  • The master branch only contains tagged releases
  • 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
  • Wherever possible, code changes should conform to PSR-2 standards
  • Helpful article about forking
  • Helpful article about pull requests

License

PhpSpreadsheet is licensed under LGPL (GNU LESSER GENERAL PUBLIC LICENSE)