mirror of
https://github.com/shuchkin/simplexlsxgen.git
synced 2023-08-10 21:12:59 +03:00
Compare commits
6 Commits
Author | SHA1 | Date | |
---|---|---|---|
8bfbe078db | |||
6ece83f9ce | |||
4f375a4c30 | |||
41c6e7ca51 | |||
ef7b0fff02 | |||
860da7f493 |
86
CHANGELOG.md
Normal file
86
CHANGELOG.md
Normal file
@ -0,0 +1,86 @@
|
|||||||
|
# Changelog
|
||||||
|
|
||||||
|
## 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
|
98
README.md
98
README.md
@ -1,12 +1,12 @@
|
|||||||
# SimpleXLSXGen class 1.0.10 (Official)
|
# SimpleXLSXGen
|
||||||
[<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)
|
[<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/>
|
Export data to Excel XLSX file. PHP XLSX generator. No external tools and libraries.<br/>
|
||||||
(!) XLSX reader [here](https://github.com/shuchkin/simplexlsx).
|
(!) XLSX reader [here](https://github.com/shuchkin/simplexlsx).
|
||||||
|
|
||||||
**Sergey Shuchkin** <sergey.shuchkin@gmail.com> 2020-2021<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
|
## Basic Usage
|
||||||
```php
|
```php
|
||||||
@ -42,49 +42,57 @@ $data = [
|
|||||||
['Time','02:38:00'],
|
['Time','02:38:00'],
|
||||||
['Datetime PHP', new DateTime('2021-02-06 21:07:00')],
|
['Datetime PHP', new DateTime('2021-02-06 21:07:00')],
|
||||||
['String', 'Long UTF-8 String in autoresized column'],
|
['String', 'Long UTF-8 String in autoresized column'],
|
||||||
['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'],
|
['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'],
|
||||||
['Hyperlink + Anchor', '<a href="https://github.com/shuchkin/simplexlsxgen">SimpleXLSXGen</a>'],
|
['Hyperlink + Anchor', '<a href="https://github.com/shuchkin/simplexlsxgen">SimpleXLSXGen</a>'],
|
||||||
['RAW string', "\0".'2020-10-04 16:02:00']
|
['RAW string', "\0".'2020-10-04 16:02:00']
|
||||||
];
|
];
|
||||||
SimpleXLSXGen::fromArray( $data )->saveAs('datatypes.xlsx'); // or ->downloadAs('datatypes.xlsx');
|
SimpleXLSXGen::fromArray( $data )->saveAs('datatypes.xlsx');
|
||||||
```
|
```
|
||||||

|

|
||||||
### Fluid examples
|
|
||||||
|
### Formatting
|
||||||
```php
|
```php
|
||||||
SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx'); // output to browser for download
|
$data = [
|
||||||
SimpleXLSXGen::fromArray( $books )->addSheet( $books2 )->download(); // multiple sheets
|
['Normal', '12345.67'],
|
||||||
(new SimpleXLSXGen)->addSheet( $books, 'Modern style')->save();
|
['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>'],
|
||||||
|
['Left', '<left>12345.67</left>'],
|
||||||
|
['Center', '<center>12345.67</center>'],
|
||||||
|
['Right', '<right>Right Text</right>'],
|
||||||
|
['Center + Bold', '<center><b>Name</b></center>']
|
||||||
|
];
|
||||||
|
SimpleXLSXGen::fromArray( $data )
|
||||||
|
->setDefaultFont( 'Courier New' )
|
||||||
|
->setDefaultFontSize( 14 )
|
||||||
|
->saveAs('styles_and_tags.xlsx');
|
||||||
```
|
```
|
||||||
### Old school, multiple sheets
|

|
||||||
|
|
||||||
|
### More examples
|
||||||
```php
|
```php
|
||||||
|
// Fluid interface, output to browser for download
|
||||||
|
SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx');
|
||||||
|
|
||||||
|
// Fluid interface, multiple sheets
|
||||||
|
SimpleXLSXGen::fromArray( $books )->addSheet( $books2 )->download();
|
||||||
|
|
||||||
|
// Alternative interface, sheet name, get xlsx content
|
||||||
|
$xlsx_cache = (string) (new SimpleXLSXGen)->addSheet( $books, 'Modern style');
|
||||||
|
|
||||||
|
// Classic interface
|
||||||
$xlsx = new SimpleXLSXGen();
|
$xlsx = new SimpleXLSXGen();
|
||||||
$xlsx->addSheet( $books, 'Catalog 2021' );
|
$xlsx->addSheet( $books, 'Catalog 2021' );
|
||||||
$xlsx->addSheet( $books2, 'Stephen King catalog');
|
$xlsx->addSheet( $books2, 'Stephen King catalog');
|
||||||
$xlsx->downloadAs('books_2021.xlsx');
|
$xlsx->downloadAs('books_2021.xlsx');
|
||||||
|
exit();
|
||||||
```
|
```
|
||||||
### Formatting
|
|
||||||
```php
|
## Debug
|
||||||
$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>'],
|
|
||||||
['Left', '<left>12345.67</left>'],
|
|
||||||
['Center', '<center>12345.67</center>'],
|
|
||||||
['Right', '<right>Right Text</right>'],
|
|
||||||
['Center + Bold', '<center><b>Name</b></center>']
|
|
||||||
];
|
|
||||||
SimpleXLSXGen::fromArray( $data )
|
|
||||||
->setDefaultFont( 'Courier New' )
|
|
||||||
->setDefaultFontSize( 14 )
|
|
||||||
->saveAs('styles_and_tags.xlsx');
|
|
||||||
```
|
|
||||||

|
|
||||||
### Debug
|
|
||||||
```php
|
```php
|
||||||
ini_set('error_reporting', E_ALL );
|
ini_set('error_reporting', E_ALL );
|
||||||
ini_set('display_errors', 1 );
|
ini_set('display_errors', 1 );
|
||||||
@ -93,24 +101,4 @@ $data = [
|
|||||||
['Debug', 123]
|
['Debug', 123]
|
||||||
]
|
]
|
||||||
SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
|
SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## History
|
|
||||||
v1.0.10 (2021-05-03) + Hyperlinks, + Minimal formatting<br/>
|
|
||||||
v0.9.25 (2021-02-26) Added PHP Datetime object values in a cells<br/>
|
|
||||||
v0.9.24 (2021-02-26) * Percent<br/>
|
|
||||||
v0.9.23 (2021-01-25) Fix local floats in XML<br/>
|
|
||||||
v0.9.22 (2020-11-04) Added multiple sheets support, thx [Savino59](https://github.com/Savino59), class ready for extend now<br/>
|
|
||||||
v0.9.21 (2020-10-17) Updated images<br/>
|
|
||||||
v0.9.20 (2020-10-04) Disable type detection if string started with chr(0)<br/>
|
|
||||||
v0.9.19 (2020-08-23) Numbers like SKU right aligned now<br/>
|
|
||||||
v0.9.18 (2020-08-22) Fixed fast shared strings index<br/>
|
|
||||||
v0.9.17 (2020-08-21) Fixed real numbers in 123.45 format detection, fast shared strings index (thx fredriksundin)<br/>
|
|
||||||
v0.9.16 (2020-07-29) Fixed time detection in HH:MM:SS format<br/>
|
|
||||||
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
|
|
@ -245,9 +245,9 @@ class SimpleXLSXGen {
|
|||||||
}
|
}
|
||||||
$xml = null;
|
$xml = null;
|
||||||
} elseif ( $cfilename === 'xl/worksheets/_rels/sheet1.xml.rels' ) {
|
} elseif ( $cfilename === 'xl/worksheets/_rels/sheet1.xml.rels' ) {
|
||||||
$RH = [];
|
|
||||||
foreach ( $this->sheets as $k => $v ) {
|
foreach ( $this->sheets as $k => $v ) {
|
||||||
if ( count($v['hyperlinks'])) {
|
if ( count($v['hyperlinks'])) {
|
||||||
|
$RH = [];
|
||||||
$filename = 'xl/worksheets/_rels/sheet' . ( $k + 1 ) . '.xml.rels';
|
$filename = 'xl/worksheets/_rels/sheet' . ( $k + 1 ) . '.xml.rels';
|
||||||
foreach ( $v['hyperlinks'] as $h ) {
|
foreach ( $v['hyperlinks'] as $h ) {
|
||||||
$RH[] = '<Relationship Id="' . $h['ID'] . '" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink" Target="' . $h['H'] . '" TargetMode="External"/>';
|
$RH[] = '<Relationship Id="' . $h['ID'] . '" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink" Target="' . $h['H'] . '" TargetMode="External"/>';
|
||||||
@ -476,7 +476,7 @@ class SimpleXLSXGen {
|
|||||||
} elseif ( preg_match( '/^([-+]?\d+)%$/', $v, $m ) ) {
|
} elseif ( preg_match( '/^([-+]?\d+)%$/', $v, $m ) ) {
|
||||||
$cv = round( $m[1] / 100, 2 );
|
$cv = round( $m[1] / 100, 2 );
|
||||||
$N = self::N_PERCENT_INT; // [9] 0%
|
$N = self::N_PERCENT_INT; // [9] 0%
|
||||||
} elseif ( preg_match( '/^([-+]\d+\.\d+)%$/', $v, $m ) ) {
|
} elseif ( preg_match( '/^([-+]?\d+\.\d+)%$/', $v, $m ) ) {
|
||||||
$cv = round( $m[1] / 100, 4 );
|
$cv = round( $m[1] / 100, 4 );
|
||||||
$N = self::N_PRECENT_DEC; // [10] 0.00%
|
$N = self::N_PRECENT_DEC; // [10] 0.00%
|
||||||
} elseif ( preg_match( '/^(\d\d\d\d)-(\d\d)-(\d\d)$/', $v, $m ) ) {
|
} elseif ( preg_match( '/^(\d\d\d\d)-(\d\d)-(\d\d)$/', $v, $m ) ) {
|
||||||
@ -496,7 +496,7 @@ class SimpleXLSXGen {
|
|||||||
$N = self::N_DATETIME; // [22] m/d/yy h:mm
|
$N = self::N_DATETIME; // [22] m/d/yy h:mm
|
||||||
} elseif ( preg_match( '/^[0-9+-.]+$/', $v ) ) { // Long ?
|
} elseif ( preg_match( '/^[0-9+-.]+$/', $v ) ) { // Long ?
|
||||||
$A = self::A_RIGHT;
|
$A = self::A_RIGHT;
|
||||||
} elseif ( preg_match( '/https?:\/\/\S+/i', $v ) ) {
|
} elseif ( preg_match( '/^https?:\/\/\S+$/i', $v ) ) {
|
||||||
$h = explode( '#', $v );
|
$h = explode( '#', $v );
|
||||||
$this->sheets[ $idx ]['hyperlinks'][] = ['ID' => 'rId' . ( count( $this->sheets[ $idx ]['hyperlinks'] ) + 1 ), 'R' => $cname, 'H' => $h[0], 'L' => isset( $h[1] ) ? $h[1] : ''];
|
$this->sheets[ $idx ]['hyperlinks'][] = ['ID' => 'rId' . ( count( $this->sheets[ $idx ]['hyperlinks'] ) + 1 ), 'R' => $cname, 'H' => $h[0], 'L' => isset( $h[1] ) ? $h[1] : ''];
|
||||||
$F = self::F_HYPERLINK; // Hyperlink
|
$F = self::F_HYPERLINK; // Hyperlink
|
||||||
|
Reference in New Issue
Block a user