# SimpleXLSXGen [](https://github.com/shuchkin/simplexlsxgen/blob/master/license.md) [](https://github.com/shuchkin/simplexlsxgen/stargazers) [](https://github.com/shuchkin/simplexlsxgen/network) [](https://github.com/shuchkin/simplexlsxgen/issues) Export data to Excel XLSX file. PHP XLSX generator. No external tools and libraries. - XLSX reader [here](https://github.com/shuchkin/simplexlsx) - XLS reader [here](https://github.com/shuchkin/simplexls) - CSV reader/writer [here](https://github.com/shuchkin/simplecsv) **Sergey Shuchkin** 2020-2023
*Hey, bro, please ★ the package for my motivation :) and [donate](https://opencollective.com/simplexlsx) for more motivation!* ## Basic Usage ```php $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 ``` ![XLSX screenshot](books.png) ## Installation The recommended way to install this library is [through Composer](https://getcomposer.org). [New to Composer?](https://getcomposer.org/doc/00-intro.md) This will install the latest supported version: ```bash $ composer require shuchkin/simplexlsxgen ``` or download class [here](https://github.com/shuchkin/simplexlsxgen/blob/master/src/SimpleXLSXGen.php) ## Examples Use UTF-8 encoded strings. ### Data types ```php $data = [ ['Integer', 123], ['Float', 12.35], ['Percent', '12%'], ['Currency $', '$500.67'], ['Currency €', '200 €'], ['Currency ₽', '1200.30 ₽'], ['Currency (other)', ''], ['Currency Float (other)', ''], ['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', 'SUM(B1:B2)'], ['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'], ['Hyperlink + Anchor', 'SimpleXLSXGen'], ['Internal link', 'Go to second page'], ['RAW string', "\0" . '2020-10-04 16:02:00'] ]; SimpleXLSXGen::fromArray($data)->saveAs('datatypes.xlsx'); ``` ![XLSX screenshot](datatypes.png) ### Formatting ```php $data = [ ['Normal', '12345.67'], ['Bold', '12345.67'], ['Italic', '12345.67'], ['Underline', '12345.67'], ['Strike', '12345.67'], ['Bold + Italic', '12345.67'], ['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'], ['Italic + Hyperlink + Anchor', 'SimpleXLSXGen'], ['Green', ''], ['Bold Red Text', ''], ['Size 32 Font', ''], ['Blue Text and Yellow Fill', ''], ['Border color', ''], ['Border style',''], ['Border sides', ''], ['Left', '12345.67'], ['Center', '
12345.67
'], ['Right', 'Right Text'], ['Center + Bold', '
Name
'], ['Row height', ''], ['Top', ''], ['Middle + Center', ''], ['Bottom + Right', ''], ['
MERGE CELLS MERGE CELLS MERGE CELLS MERGE CELLS MERGE CELLS
', null], ['Word wrap', "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"], ]; SimpleXLSXGen::fromArray($data) ->setDefaultFont('Courier New') ->setDefaultFontSize(14) ->setColWidth(1, 35) ->mergeCells('A20:B20') ->saveAs('styles_and_tags.xlsx'); ``` ![XLSX screenshot](styles.png) ### RAW Strings Prefix #0 cell value (use double quotes). ```php $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', "\0".'20- short term: <6 month'], ]; SimpleXLSXGen::fromArray($data) ->saveAs('test_rawstrings.xlsx'); ``` ### More examples ```php // Fluid interface, output to browser for download Shuchkin\SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx'); // Fluid interface, multiple sheets Shuchkin\SimpleXLSXGen::fromArray( $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(); // Autofilter $xlsx->autoFilter('A1:B10'); // Comment cell $xlsx->setComment("B2", "Comment text", "Comment author"); // Freeze rows and columns from top-left corner up to, but not including, // the row and column of the indicated cell (in A1 format as string or // R1C1 format as 2-element integer array) $xlsx->freezePanes('C3'); // 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('Sergey Shuchkin ') ->setCompany('Microsoft ') ->setManager('Bill Gates ') ->setLastModifiedBy("Sergey Shuchkin ") ->setTitle('This is Title') ->setSubject('This is Subject') ->setKeywords('Keywords1, Keywords2, Keywords3, KeywordsN') ->setDescription('This is Description') ->setCategory('This is Сategory') ->setApplication('Shuchkin\SimpleXLSXGen') ``` ### JS array to Excel (AJAX) ```php downloadAs('file.xlsx'); return; } ?> JS array to Excel ``` ## Notes * When XLSX file is generated (__toString, saveAs or downloadAs methods), the data matrix of each sheet is traversed by rows and columns using foreach cycles. This implies freedom in the type of indexes used for the data but it also implies paying special attention when using numeric indexes since the array is traversed in the order in which they were defined and not in the numerical order of said indexes. * The helper methods for setting and getting the styles of a range or cell, implies that the data was defined as a 2-dimensional array (matrix) with consecutive 0-based numeric indexes. * If you use download or downloadAs methods, make sure you don't generate output before (not important if you use output buffering) and after you call the method. Pay special attention to whitespaces characters (space, cr/lf, tab) in source files before and after PHP code closing tags. If you inadvertently, or on purpose, generate text output, the resulting XLSX file will be corrupted. * Methods setDefaultFont, setDefaultFontSize, setTitle, setSubject, setAuthor, setCompany, setManager, setKeywords, setDescription, setCategory, setApplication, setLastModifiedBy and rightToLeft apply to the entire book. * Methods autoFilter, mergeCells, setColWidth, freezePanes and setComment apply to the current sheet (the last addSheet/fromArray used) ## Debug ```php ini_set('error_reporting', E_ALL ); ini_set('display_errors', 1 ); $data = [ ['Debug', 123] ]; Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx'); ```