Compare commits
35 Commits
Author | SHA1 | Date |
---|---|---|
Sergey Shuchkin | 306aa7dad9 | |
Oleg Kosarev | dc974d2ef9 | |
Sergey Shuchkin | c78750ffe7 | |
Sergey Shuchkin | 9cdb08ee98 | |
Oleg Kosarev | 32276c4486 | |
Oleg Kosarev | 3646e702ae | |
Oleg Kosarev | 81120e6f72 | |
Oleg Kosarev | c449813bb1 | |
Oleg Kosarev | 4f4ac11dae | |
Sergey Shuchkin | 1fa442f667 | |
Sergey Shuchkin | 1ee4e5eb50 | |
Sergey Shuchkin | e02d764d0d | |
Sergey Shuchkin | f65e57c735 | |
Javier | 4f3d09925c | |
Javier | 95da6b5c05 | |
Sergey Shuchkin | b3060667f2 | |
Sergey Shuchkin | cb19defa37 | |
Sergey Shuchkin | 5a154b24f9 | |
Sergey Shuchkin | b46f63fce7 | |
Andrew Robinson | bb09c0d38c | |
Andrew Robinson | 91ca3f6fff | |
Sergey Shuchkin | 59cdc277ee | |
Sergey Shuchkin | 343e549ca1 | |
Sergey Shuchkin | 61e55d6277 | |
Javier | 9b52ff6ac7 | |
Javier | 317fb0982e | |
Sergey Shuchkin | 765001ae96 | |
Sergey Shuchkin | c2f3077812 | |
Sergey Shuchkin | af53c754c3 | |
Sergey Shuchkin | 6d7608f8ca | |
Sergey Shuchkin | 80091bb9be | |
Sergey Shuchkin | 21b1d9a4b8 | |
Sergey Shuchkin | c1434378bc | |
Sergey Shuchkin | 75252a4a0c | |
Robin | f9d5480bb3 |
23
CHANGELOG.md
23
CHANGELOG.md
|
@ -1,4 +1,27 @@
|
|||
# Changelog
|
||||
|
||||
## 1.3.15 (2023-04-19)
|
||||
* added meta: setTitle, setSubject, setAuthor, setCompany, setManager, setKeywords, setDescription, setCategory, setApplication, setLastModifiedBy. Thx [Oleg Kosarev](https://github.com/DevOlegKosarev)
|
||||
|
||||
## 1.3.14 (2023-04-18)
|
||||
* fixed "This action doesn't work on multiple selection" error
|
||||
|
||||
## 1.3.13 (2023-04-11)
|
||||
* ```$xlsx->rightToLeft()``` - 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.
|
||||
|
||||
## 1.3.12 (2023-03-31)
|
||||
* ```<style font-size="32">Big Text</style>``` - font size in cells, thx [Andrew Robinson](https://github.com/mrjemson)
|
||||
|
||||
## 1.3.11 (2023-03-28)
|
||||
* freezePanes( corner_cell ) - freezePanes to keep an area of a worksheet visible while you scroll, corner_cell is not included, thx [Javier](https://github.com/xaviermdq)
|
||||
|
||||
## 1.3.10 (2022-12-14)
|
||||
* added borders ```<style border="medium">Black Border</style>``` see colored [examples](https://github.com/shuchkin/simplexlsxgen#formatting)
|
||||
* added formulas ```<f v="100">SUM(B1:B10)</f>``` see [examples](https://github.com/shuchkin/simplexlsxgen#data-types)
|
||||
* added internal links ```<a href="sheet2!A1">Go to page 2</a>```
|
||||
* added custom number formats ```<style nf=""£"#,##0.00">500</style>```
|
||||
* added 3 currencies ```$data = [ ['$100.23', '2000.00 €', '1200.30 ₽'] ];```
|
||||
|
||||
## 1.2.16 (2022-08-12)
|
||||
* added `autoFilter( $range )`
|
||||
```php
|
||||
|
|
69
README.md
69
README.md
|
@ -6,7 +6,7 @@ Export data to Excel XLSX file. PHP XLSX generator. No external tools and librar
|
|||
- XLS reader [here](https://github.com/shuchkin/simplexls)
|
||||
- CSV reader/writer [here](https://github.com/shuchkin/simplecsv)
|
||||
|
||||
**Sergey Shuchkin** <sergey.shuchkin@gmail.com> 2020-2022<br/>
|
||||
**Sergey Shuchkin** <sergey.shuchkin@gmail.com> 2020-2023<br/>
|
||||
|
||||
*Hey, bro, please ★ the package for my motivation :) and [donate](https://opencollective.com/simplexlsx) for more motivation!*
|
||||
|
||||
|
@ -33,22 +33,30 @@ $ 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)', '<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'],
|
||||
['Date', '2020-05-20'],
|
||||
['Time', '02:38:00'],
|
||||
['Datetime PHP', new DateTime('2021-02-06 21:07:00')],
|
||||
['String', 'Long UTF-8 String in autoresized column'],
|
||||
['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>'],
|
||||
['RAW string', "\0".'2020-10-04 16:02:00']
|
||||
['Internal link', '<a href="sheet2!A1">Go to second page</a>'],
|
||||
['RAW string', "\0" . '2020-10-04 16:02:00']
|
||||
];
|
||||
Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('datatypes.xlsx');
|
||||
SimpleXLSXGen::fromArray($data)->saveAs('datatypes.xlsx');
|
||||
```
|
||||
![XLSX screenshot](datatypes.png)
|
||||
|
||||
|
@ -65,7 +73,11 @@ $data = [
|
|||
['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>'],
|
||||
|
@ -75,17 +87,32 @@ $data = [
|
|||
['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>"]
|
||||
['<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>"],
|
||||
];
|
||||
SimpleXLSXGen::fromArray( $data )
|
||||
->setDefaultFont( 'Courier New' )
|
||||
->setDefaultFontSize( 14 )
|
||||
->setColWidth(1, 35) // 1 - num column, 35 - size in chars
|
||||
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
|
||||
|
@ -108,6 +135,26 @@ exit();
|
|||
// 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('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 <sergey.shuchkin@gmail.com>')
|
||||
->setCompany('Microsoft <info@microsoft.com>')
|
||||
->setManager('Bill Gates <bill.gates@microsoft.com>')
|
||||
->setLastModifiedBy("Sergey Shuchkin <sergey.shuchkin@gmail.com>")
|
||||
->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
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"name": "shuchkin/simplexlsxgen",
|
||||
"description": "Export data to Excel XLSx file. PHP XLSX generator.",
|
||||
"keywords": ["php", "excel", "xlsx", "generator", "creator", "backend"],
|
||||
"keywords": ["php", "excel", "xlsx", "generator", "writer", "creator", "backend"],
|
||||
"homepage": "https://github.com/shuchkin/simplexlsxgen",
|
||||
"license": "MIT",
|
||||
"authors": [
|
||||
|
|
BIN
datatypes.png
BIN
datatypes.png
Binary file not shown.
Before Width: | Height: | Size: 45 KiB After Width: | Height: | Size: 14 KiB |
File diff suppressed because it is too large
Load Diff
BIN
styles.png
BIN
styles.png
Binary file not shown.
Before Width: | Height: | Size: 40 KiB After Width: | Height: | Size: 190 KiB |
Loading…
Reference in New Issue