shuchkin / simplexlsxgen
Export data to Excel XLSx file. PHP XLSX generator.
Installs: 1 436 860
Dependents: 8
Suggesters: 1
Security: 0
Stars: 1 002
Watchers: 22
Forks: 201
Open Issues: 23
Requires
- php: >=5.4
- ext-mbstring: *
- ext-zlib: *
- dev-master
- 1.4.13
- 1.4.12
- 1.4.11
- 1.4.10
- 1.3.20
- 1.3.19
- 1.3.18
- 1.3.17
- 1.3.16
- 1.3.15
- 1.3.14
- 1.3.13
- 1.3.12
- 1.3.11
- 1.3.10
- 1.2.16
- 1.2.15
- 1.2.14
- 1.2.13
- 1.2.12
- 1.2.11
- 1.2.10
- 1.1.12
- 1.1.11
- 1.1.10
- 1.0.23
- 1.0.22
- 1.0.21
- 1.0.20
- 1.0.19
- 1.0.18
- 1.0.17
- 1.0.16
- 1.0.15
- 1.0.14
- 1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 0.9.25
- 0.9.24
- 0.9.23
- 0.9.22.x-dev
- 0.9.22
- 0.9.21
- 0.9.20
- 0.9.19
- 0.9.18
- 0.9.17
- 0.9.16
- 0.9.15
- 0.9.14
- 0.9.13
- 0.9.12
- 0.9.11
- 0.9.10
This package is auto-updated.
Last update: 2024-12-05 05:36:18 UTC
README
Export data to Excel XLSX file. PHP XLSX generator. No external tools and libraries.
Sergey Shuchkin sergey.shuchkin@gmail.com 2020-2024
Hey, bro, please ★ the package for my motivation :) and donate for more motivation!
Basic Usage
$books = [ ['ISBN', 'title', 'author', 'publisher', 'ctry' ], [618260307, 'The Hobbit', 'J. R. R. Tolkien', 'Houghton Mifflin', 'USA'], [908606664, 'Slinky Malinki', 'Lynley Dodd', 'Mallinson Rendel', 'NZ'] ]; $xlsx = Shuchkin\SimpleXLSXGen::fromArray( $books ); $xlsx->saveAs('books.xlsx'); // or downloadAs('books.xlsx') or $xlsx_content = (string) $xlsx
Installation
The recommended way to install this library is through Composer. New to Composer?
This will install the latest supported version:
$ composer require shuchkin/simplexlsxgen
or download class here
Examples
Use UTF-8 encoded strings.
Data types
$data = [ ['Integer', 123], ['Float', 12.35], ['Percent', '12%'], ['Currency $', '$500.67'], ['Currency €', '200 €'], ['Currency ₽', '1200.30 ₽'], ['Currency (other)', '<style nf=""£"#,##0.00">500</style>'], ['Currency Float (other)', '<style nf="#,##0.00\ [$£-1];[Red]#,##0.00\ [$£-1]">500.250</style>'], ['Datetime', '2020-05-20 02:38:00'], ['Date', '2020-05-20'], ['Time', '02:38:00'], ['Datetime PHP', new DateTime('2021-02-06 21:07:00')], ['String', 'Very long UTF-8 string in autoresized column'], ['Formula', '<f v="135.35">SUM(B1:B2)</f>'], ['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'], ['Hyperlink + Anchor', '<a href="https://github.com/shuchkin/simplexlsxgen">SimpleXLSXGen</a>'], ['Internal link', '<a href="sheet2!A1">Go to second page</a>'], ['RAW string', "\0" . '2020-10-04 16:02:00'], ['Formatted RAW string', '<b><i><raw>2024-07-28 16:02:00</raw></i></b>'], ]; SimpleXLSXGen::fromArray($data)->saveAs('datatypes.xlsx');
Formatting
$data = [ ['Normal', '12345.67'], ['Bold', '<b>12345.67</b>'], ['Italic', '<i>12345.67</i>'], ['Underline', '<u>12345.67</u>'], ['Strike', '<s>12345.67</s>'], ['Bold + Italic', '<b><i>12345.67</i></b>'], ['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'], ['Italic + Hyperlink + Anchor', '<i><a href="https://github.com/shuchkin/simplexlsxgen">SimpleXLSXGen</a></i>'], ['Green', '<style color="#00FF00">12345.67</style>'], ['Bold Red Text', '<b><style color="#FF0000">12345.67</style></b>'], ['Size 32 Font', '<style font-size="32">Big Text</style>'], ['Blue Text and Yellow Fill', '<style bgcolor="#FFFF00" color="#0000FF">12345.67</style>'], ['Border color', '<style border="#000000">Black Thin Border</style>'], ['<top>Border style</top>','<style border="medium"><wraptext>none, thin, medium, dashed, dotted, thick, double, hair, mediumDashed, dashDot,mediumDashDot, dashDotDot, mediumDashDotDot, slantDashDot</wraptext></style>'], ['Border sides', '<style border="none dotted#0000FF medium#FF0000 double">Top No + Right Dotted + Bottom medium + Left double</style>'], ['Left', '<left>12345.67</left>'], ['Center', '<center>12345.67</center>'], ['Right', '<right>Right Text</right>'], ['Center + Bold', '<center><b>Name</b></center>'], ['Row height', '<style height="50">Row Height = 50</style>'], ['Top', '<style height="50"><top>Top</top></style>'], ['Middle + Center', '<style height="50"><middle><center>Middle + Center</center></middle></style>'], ['Bottom + Right', '<style height="50"><bottom><right>Bottom + Right</right></bottom></style>'], ['<center>MERGE CELLS MERGE CELLS MERGE CELLS MERGE CELLS MERGE CELLS</center>', null], ['<top>Word wrap</top>', "<wraptext>Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book</wraptext>"], ['Linebreaks', "Line 1\nLine 2\nLine 3"] ]; SimpleXLSXGen::fromArray($data) ->setDefaultFont('Courier New') ->setDefaultFontSize(14) ->setColWidth(1, 35) ->mergeCells('A20:B20') ->saveAs('styles_and_tags.xlsx');
RAW Strings
Prefix #0 cell value (use double quotes) or use ::raw() method, or tag <raw>
$PushkinDOB = '1799-07-06'; $data = [ ['Datetime as raw string', "\0".'2023-01-09 11:16:34'], ['Date as raw string', "\0".$PushkinDOB], ['Disable type detection', "\0".'+12345'], ['Insert greater/less them simbols', SimpleXLSXGen::raw('20- short term: <6 month')], ['Formatted raw', '<b><center><raw>+123456 <tag><tag2></raw></center></b>'], ]; SimpleXLSXGen::fromArray($data) ->saveAs('test_rawstrings.xlsx');
More examples
// Fluid interface, output to browser for download Shuchkin\SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx'); // Fluid interface, multiple sheets Shuchkin\SimpleXLSXGen::fromArray( $books, 'My books' )->addSheet( $books2 )->download(); // Alternative interface, sheet name, get xlsx content $xlsx_cache = (string) (new Shuchkin\SimpleXLSXGen)->addSheet( $books, 'Modern style'); // Classic interface use Shuchkin\SimpleXLSXGen; $xlsx = new SimpleXLSXGen(); $xlsx->addSheet( $books, 'Catalog 2021' ); $xlsx->addSheet( $books2, 'Stephen King catalog'); $xlsx->downloadAs('books_2021.xlsx'); exit(); // Empty book with title $xlsx = SimpleXLSX::create('My books'); $xlsx->addSheet( $books ); $xlsx->save(); // ./My books.xlsx // Hyperlinks $xlsx = SimpleXLSX::fromArray([ ['internal link', '<a href="\'My books 2\'!A1">Go to second sheet</a>'], ['http', 'https://example.com/'], // autodetect ['http + hash', 'https://en.wikipedia.org/wiki/Office_Open_XML#References'], // autodetect ['external anchor', '<a href="https://en.wikipedia.org/wiki/Office_Open_XML#References">Open XML</a>'], ['relative link', '<a href="books.xlsx">books</a>'], ['relative link + cell addr', '<a href="..\books.xlsx#\'Sheet 2\'!A1">link to second sheet in other book</a>'], ['mailto', 'info@example.com'], // autodetect ['mailto 2', '<a href="mailto:info@example.com">Please email me</a>'], ])->addSheet([['Second sheet']], 'My books 2')->saveAs('hyperlinks.xlsx'); // Autofilter $xlsx->autoFilter('A1:B10'); // Freeze rows and columns from top-left corner up to, but not including, // the row and column of the indicated cell $xlsx->freezePanes('B2'); // B1 - freeze first column, A2 - freeze top row // RTL mode // Column A is on the far right, Column B is one column left of Column A, and so on. // Also, information in cells is displayed in the Right to Left format. $xlsx->rightToLeft(); // Set Meta Data Files // this data in propertis Files and Info file in Office $xlsx->setAuthor('John Doe <john@example.com>') ->setCompany('JD LLC <jd@mexample.com>') ->setManager('Jane Doe <jane@example.com>') ->setLastModifiedBy("John Doe <john@example.com>") ->setTitle('My Books') ->setSubject('My bookshelf') ->setKeywords('Tolkien,Rowling,Kipling') ->setDescription('Cool books worn by time') ->setCategory('Books') ->setLanguage('en-US') ->setApplication('Shuchkin\SimpleXLSXGen')
JS array to Excel (AJAX)
<?php // array2excel.php if (isset($_POST['array2excel'])) { require __DIR__.'/simplexlsxgen/src/SimpleXLSXGen.php'; $data = json_decode($_POST['array2excel'], false); \Shuchkin\SimpleXLSXGen::fromArray($data)->downloadAs('file.xlsx'); return; } ?> <html lang="en"> <head> <title>JS array to Excel</title> </head> <script> function array2excel() { var books = [ ["ISBN", "title", "author", "publisher", "ctry"], [618260307, "The Hobbit", "J. R. R. Tolkien", "Houghton Mifflin", "USA"], [908606664, "Slinky Malinki", "Lynley Dodd", "Mallinson Rendel", "NZ"] ]; var json = JSON.stringify(books); var request = new XMLHttpRequest(); request.onload = function () { if (this.status === 200) { var file = new Blob([this.response], {type: this.getResponseHeader('Content-Type')}); var fileURL = URL.createObjectURL(file); var filename = "", m; var disposition = this.getResponseHeader('Content-Disposition'); if (disposition && (m = /"([^"]+)"/.exec(disposition)) !== null) { filename = m[1]; } var a = document.createElement("a"); if (typeof a.download === 'undefined') { window.location = fileURL; } else { a.href = fileURL; a.download = filename; document.body.appendChild(a); a.click(); } } else { alert("Error: " + this.status + " " + this.statusText); } } request.open('POST', "array2excel.php"); request.responseType = "blob"; request.setRequestHeader("Content-Type", "application/x-www-form-urlencoded"); request.send("array2excel=" + encodeURIComponent(json)); } </script> <body> <input type="button" onclick="array2excel()" value="array2excel" /> </body> </html>
Debug
ini_set('error_reporting', E_ALL ); ini_set('display_errors', 1 ); $data = [ ['Debug', 123] ]; Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');