PhpSpreadsheet/README.md

3.9 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)

Want to contribute?

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

  • All new development happens on the 1.9 branch, so it is always the most up-to-date
  • The master branch only contains tagged releases
  • If you are going to be submitting a pull request, please fork from 1.9, and submit your pull request back to that 1.9 branch
  • 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)