1
0
mirror of https://github.com/shuchkin/simplexlsxgen.git synced 2023-08-10 21:12:59 +03:00

67 Commits

Author SHA1 Message Date
ff3f016358 1.2.11 2022-04-30 14:08:40 +06:00
bcd3586731 1.2.10 2022-04-30 14:04:13 +06:00
402c6b9417 1.2.10 2022-04-24 14:59:15 +06:00
5840fd5285 Merge pull request #58 from mrjemson/master
Added Font Color and Background Color Capabilities
2022-04-23 13:07:03 +06:00
4543922330 Updated examples 2022-04-23 11:34:13 +10:00
d49f8996df Switched to style tags 2022-04-23 11:33:17 +10:00
5309e6a002 Removed duplicate line 2022-04-22 23:21:40 +10:00
ab28bc319d Added missing line break 2022-04-22 23:19:38 +10:00
e145bd5777 Updated examples to include background fill 2022-04-22 23:16:28 +10:00
2ee7237016 Updated class to include background fill options 2022-04-22 23:15:35 +10:00
a0a932e2f5 Updated Styles Image for Background Fill 2022-04-22 23:14:42 +10:00
fc884044ac Color Code Clean Up 2022-04-22 18:03:17 +10:00
d84c842d38 Corrected const C_NORMAL value 2022-04-22 17:59:30 +10:00
0dafc8bf9e Fixes for color updates 2022-04-22 17:58:25 +10:00
82f19a9f35 Updated styles.png 2022-04-22 17:54:51 +10:00
139602c340 Update README.md 2022-04-22 17:51:35 +10:00
ac34d8f527 Added Font Color 2022-04-22 16:43:26 +10:00
c55d77c63e 1.1.12 2022-03-15 21:49:14 +06:00
c3d10db967 1.1.12 2022-03-15 21:47:33 +06:00
1c206d06bc 1.1.11 2022-02-12 03:25:59 +06:00
f0cbc32af9 1.1.11 2022-02-12 03:04:46 +06:00
121f1222c2 1.1.10 2022-02-05 18:32:10 +06:00
40eb704eb2 1.0.23 2022-02-01 02:50:32 +06:00
4005e8cbd1 Merge pull request #48 from appel/patch-1
added a ; in the Debug section.
2021-11-28 20:43:00 +06:00
9d82a43fe6 added a ; in the Debug section. 2021-11-28 08:48:15 -05:00
9a555eef9b 1.0.22 2021-10-29 03:37:04 +06:00
79ffbb5e30 1.0.21 2021-09-20 00:51:25 +06:00
868cf8edc0 1.0.21 2021-09-03 22:12:48 +06:00
7f5c584772 1.0.20 2021-07-29 12:16:10 +06:00
5b58103e3b 1.0.19 2021-07-28 22:01:02 +06:00
6d49a90fe7 1.0.18 2021-07-28 05:06:23 +06:00
c8a94d552a 1.0.17 2021-07-28 01:45:25 +06:00
c9fa7da689 1.0.16 2021-07-01 03:03:57 +06:00
0d059fdf6e 1.0.16 2021-07-01 03:01:35 +06:00
dcb5f8ad65 1.0.15 2021-06-22 00:57:29 +06:00
f970452779 1.0.14 2021-06-08 09:59:42 +06:00
6abd0286bb 1.0.14 2021-06-08 09:51:10 +06:00
8bfbe078db 1.0.13 2021-05-29 23:21:45 +06:00
6ece83f9ce 1.0.12 2021-05-19 10:21:09 +06:00
4f375a4c30 1.0.11 2021-05-14 16:52:30 +06:00
41c6e7ca51 Merge pull request #34 from marcrobledo/marcrobledo-fix-percentage
fix percentage with decimals
2021-05-14 16:37:33 +06:00
ef7b0fff02 fix percentage with decimals
make sign optional for percentage values with decimals
2021-05-14 10:55:07 +02:00
860da7f493 1.0.10 2021-05-03 03:22:26 +06:00
eeec88dbf0 1.0.10 2021-05-03 03:19:14 +06:00
1e866f82bf 1.0.10 2021-05-03 03:17:24 +06:00
17098b57ef 1.0.10 2021-05-03 03:08:41 +06:00
ab49ffadd7 example $xlsx_content = (string) $xlsx 2021-03-01 00:09:42 +06:00
99c6be2fb4 Added PHP Datetime object values in a cells 2021-02-26 21:45:38 +06:00
d1ccfc6f17 Added PHP Datetime object values in a cells 2021-02-26 21:39:13 +06:00
21db9eca96 * percent 2021-02-26 12:55:41 +06:00
8b6d0505b5 Fix local floats in XML 2021-01-25 22:43:37 +06:00
205396b998 Fix local floats in XML 2021-01-25 22:19:37 +06:00
42558401ef Multiple sheets support and class ready for extends now 2020-11-04 01:42:52 +06:00
07d3e91c28 Merge pull request #14 from Savino59/master
added multisheet support (keeping it compatible to the original version)
2020-11-03 20:14:34 +06:00
3abb47b9b4 added multisheet support (keeping it compatible to the original version) 2020-11-02 17:34:19 +01:00
0fc338d802 update images 2020-10-17 01:13:17 +06:00
a8093b9d8e Merge remote-tracking branch 'origin/master' 2020-10-04 16:08:32 +06:00
a9219575df disable type detection 2020-10-04 16:08:12 +06:00
476e083f29 Merge pull request #8 from jturbide/master
Fix invalid content
2020-08-28 00:26:29 +06:00
db598d4ee4 Update SimpleXLSXGen.php 2020-08-26 17:15:14 -04:00
a551f6485b Long Numbers format 2020-08-23 15:07:29 +06:00
aafe6abd5b fixed fast shared strings index 2020-08-22 13:54:34 +06:00
9b2c9d3e1c Fixed real numbers in 123.45 format detection, fast shared strings index 2020-08-21 21:57:02 +06:00
9824e5b25d Merge pull request #4 from fredriksundin/performance
Replace array_search to optimize large arrays
2020-08-21 21:40:15 +06:00
c3d64d13ef Fix strict compare bug 2020-08-19 23:09:33 +00:00
22cbd84f3c Add strict compare 2020-08-19 22:48:12 +00:00
291b508143 Replace array_search to optimize large arrays 2020-08-19 22:41:08 +00:00
9 changed files with 913 additions and 377 deletions

6
.gitignore vendored
View File

@ -1 +1,5 @@
vendor*
/vendor*
/books.fw.png
/datatypes.fw.png
/styles.fw.png
/.gitignore

115
CHANGELOG.md Normal file
View File

@ -0,0 +1,115 @@
# Changelog
## 1.2.11 (2022-)
* Row height `<style height="50">Custom row height 50</style>`
## 1.2.10 (2022-04-24)
* Added colors `<style color="#FFFF00" bgcolor="#00FF00">Yellow text on blue background</style>`, thx [mrjemson](https://github.com/mrjemson)
## 1.1.12 (2022-03-15)
* Added `$xlsx->mergeCells('A1:C1')`
## 1.1.11 (2022-02-05)
* sheet name maximum length is 31 chars, mb_substr used now
* license fixed
## 1.1.10 (2022-02-05)
* namespace added, use Shuchkin\SimpleXLSXGen
## 1.0.23 (2022-02-01)
* fixed dates if year < 1900 and time only cells, thx [fapth](https://github.com/shuchkin/simplexlsxgen/issues/51)
## 1.0.22 (2021-10-29)
* Escape \x00 and \x0B (vertical tab)
## 1.0.21 (2021-09-03)
* Fixed saveAs / downloadAs / etc methods more than once
## 1.0.20 (2021-07-29)
* Fixed sheet names duplicates (Page, Page (1), Page (2)...)
## 1.0.19 (2021-07-28)
* Fixed sheet names duplicates
## 1.0.18 (2021-07-28)
* Fixed email regex
## 1.0.17 (2021-07-28)
* Fixed &quot; and &amp; in sheets names
## 1.0.16 (2021-07-01)
* Fixed &quot;&amp;&quot; in hyperlinks
## 1.0.15 (2021-06-22)
* Fixed *mailto* hyperlinks detection
## 1.0.14 (2021-06-08)
* Added *mailto* hyperlinks support (thx Howard Martin)
```php
SimpleXLSXGen::fromArray([
['Mailto hyperlink', '<a href="mailto:sergey.shuchkin@gmail.com">Please email me</a>']
])->saveAs('test.xlsx');
```
## 1.0.13 (2021-05-29)
* Fixed hyperlinks in several sheets
* Added [Opencollective donation link](https://opencollective.com/simplexlsx)
## 1.0.12 (2021-05-19)
* Fixed hyperlink regex
## 1.0.11 (2021-05-14)
* Fixed 0.00% format, thx [marcrobledo](https://github.com/shuchkin/simplexlsxgen/pull/34), more examples in README.md
## 1.0.10 (2021-05-03)
Stable release
* Added hyperlinks and minimal formatting
## 0.9.25 (2021-02-26)
* Added PHP Datetime object values in a cells
## 0.9.24 (2021-02-26)
* Percent support
## 0.9.23 (2021-01-25)
* Fix local floats in XML
## 0.9.22 (2020-11-04)
* Added multiple sheets support, thx [Savino59](https://github.com/Savino59), class ready for extend now
## 0.9.21 (2020-10-17)
* Updated images
## 0.9.20 (2020-10-04)
* Disable type detection if string started with chr(0)
## 0.9.19 (2020-08-23)
* Numbers like SKU right aligned now
## 0.9.18 (2020-08-22)
* Fixed fast shared strings index
## 0.9.17 (2020-08-21)
* Fixed real numbers in 123.45 format detection, fast shared strings index (thx fredriksundin)
## 0.9.16 (2020-07-29)
* Fixed time detection in HH:MM:SS format
## 0.9.15 (2020-07-14)
* Escape of shared strings for special chars in cells [#1](https://github.com/shuchkin/simplexlsxgen/issues/1)
## 0.9.14 (2020-05-31)
* Fixed num2name A-Z,AA-AZ column names, thx Ertan Yusufoglu
## 0.9.13 (2020-05-21)
* If string more 160 chars, save as inlineStr
## 0.9.12 (2020-05-21)
* Readme fixed
## 0.9.11 (2020-05-21)
* Removed XML unimportant attributes
## 0.9.10 (2020-05-20)
* Initial release

View File

@ -1,12 +1,14 @@
# SimpleXLSXGen class 0.9.16 (Official)
[<img src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.herokuapp.com%2Fshuchkin" />](https://www.patreon.com/shuchkin) [<img src="https://img.shields.io/github/license/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/blob/master/license.md) [<img src="https://img.shields.io/github/stars/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/stargazers) [<img src="https://img.shields.io/github/forks/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/network) [<img src="https://img.shields.io/github/issues/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/issues)
# SimpleXLSXGen
[<img src="https://img.shields.io/github/license/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/blob/master/license.md) [<img src="https://img.shields.io/github/stars/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/stargazers) [<img src="https://img.shields.io/github/forks/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/network) [<img src="https://img.shields.io/github/issues/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/issues)
Export data to Excel XLSX file. PHP XLSX generator. No external tools and libraries.<br/>
(!) XLSX reader [here](https://github.com/shuchkin/simplexlsx).
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** <sergey.shuchkin@gmail.com> 2020<br/>
**Sergey Shuchkin** <sergey.shuchkin@gmail.com> 2020-2021<br/>
*Hey, bro, please ★ the package for my motivation :)*
*Hey, bro, please ★ the package for my motivation :) and [donate](https://opencollective.com/simplexlsx) for more motivation!*
## Basic Usage
```php
@ -15,13 +17,10 @@ $books = [
[618260307, 'The Hobbit', 'J. R. R. Tolkien', 'Houghton Mifflin', 'USA'],
[908606664, 'Slinky Malinki', 'Lynley Dodd', 'Mallinson Rendel', 'NZ']
];
$xlsx = SimpleXLSXGen::fromArray( $books );
$xlsx->saveAs('books.xlsx');
$xlsx = Shuchkin\SimpleXLSXGen::fromArray( $books );
$xlsx->saveAs('books.xlsx'); // or downloadAs('books.xlsx') or $xlsx_content = (string) $xlsx
```
![XLSX screenshot](books.png)
```
// SimpleXLSXGen::download() or SimpleXSLSXGen::downloadAs('table.xlsx');
```
## Installation
The recommended way to install this library is [through Composer](https://getcomposer.org).
@ -39,33 +38,76 @@ or download class [here](https://github.com/shuchkin/simplexlsxgen/blob/master/s
$data = [
['Integer', 123],
['Float', 12.35],
['Procent', '12%'],
['Percent', '12%'],
['Datetime', '2020-05-20 02:38:00'],
['Date','2020-05-20'],
['Time','02:38:00'],
['String', 'See SimpleXLSXGen column autosize feature']
['Time','02:38:00'],
['Datetime PHP', new DateTime('2021-02-06 21:07:00')],
['String', 'Long UTF-8 String in autoresized column'],
['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'],
['Hyperlink + Anchor', '<a href="https://github.com/shuchkin/simplexlsxgen">SimpleXLSXGen</a>'],
['RAW string', "\0".'2020-10-04 16:02:00']
];
SimpleXLSXGen::fromArray( $data )->saveAs('datatypes.xlsx');
Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('datatypes.xlsx');
```
![XLSX screenshot](datatypes.png)
### Debug
### Formatting
```php
$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>'],
['Blue Text and Yellow Fill', '<style bgcolor="#FFFF00" color="#0000FF">12345.67</style>'],
['Left', '<left>12345.67</left>'],
['Center', '<center>12345.67</center>'],
['Right', '<right>Right Text</right>'],
['Center + Bold', '<center><b>Name</b></center>'],
['<center>MERGE CELLS</center>', null]
];
SimpleXLSXGen::fromArray( $data )
->setDefaultFont( 'Courier New' )
->setDefaultFontSize( 14 )
->mergeCells('A16:B16')
->saveAs('styles_and_tags.xlsx');
```
![XLSX screenshot](styles.png)
### 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();
```
## Debug
```php
ini_set('error_reporting', E_ALL );
ini_set('display_errors', 1 );
$data = [
['Debug', 123]
]
SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
];
Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
```
## History
v0.9.16 (2020-07-29) Fixed time detection in HH:MM:SS format
v0.9.15 (2020-07-14) escape of shared strings for special chars in cells [#1](https://github.com/shuchkin/simplexlsxgen/issues/1) <br/>
v0.9.14 (2020-05-31) fixed num2name A-Z,AA-AZ column names, thx Ertan Yusufoglu<br/>
v0.9.13 (2020-05-21) if string more 160 chars, save as inlineStr<br/>
v0.9.12 (2020-05-21) readme fixed<br/>
v0.9.11 (2020-05-21) removed XML unimportant attributes<br/>
v0.9.10 (2020-05-20) initial release

BIN
books.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 22 KiB

View File

@ -17,6 +17,7 @@
]
},
"require": {
"php": ">=5.4",
"ext-mbstring": "*",
"ext-zlib": "*"
}

Binary file not shown.

Before

Width:  |  Height:  |  Size: 87 KiB

After

Width:  |  Height:  |  Size: 45 KiB

View File

@ -1,6 +1,6 @@
The MIT License (MIT)
Copyright (c) 2014 Lukas Martinelli
Copyright (c) 2020-2022 Sergey Shuchkin sergey.shuchkin@gmail.com
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal

File diff suppressed because it is too large Load Diff

BIN
styles.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB