1.1.12

added a ; in the Debug section.

.gitignore

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

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+# 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)
 

README.md

@@ -1,8 +1,10 @@
 # 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-2021<br/>
 
@@ -15,7 +17,7 @@ $books = [
     [618260307, 'The Hobbit', 'J. R. R. Tolkien', 'Houghton Mifflin', 'USA'],
     [908606664, 'Slinky Malinki', 'Lynley Dodd', 'Mallinson Rendel', 'NZ']
 ];
-$xlsx = SimpleXLSXGen::fromArray( $books );
+$xlsx = Shuchkin\SimpleXLSXGen::fromArray( $books );
 $xlsx->saveAs('books.xlsx'); // or downloadAs('books.xlsx') or $xlsx_content = (string) $xlsx 
 ```
 ![XLSX screenshot](books.png)
@@ -46,7 +48,7 @@ $data = [
     ['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)
 
@@ -64,11 +66,13 @@ $data = [
     ['Left', '<left>12345.67</left>'],
     ['Center', '<center>12345.67</center>'],
     ['Right', '<right>Right Text</right>'],
-    ['Center + Bold', '<center><b>Name</b></center>']
+    ['Center + Bold', '<center><b>Name</b></center>'],
+    ['<center>MERGE CELLS</center>']
 ];
-SimpleXLSXGen::fromArray( $data )
+Shuchkin\SimpleXLSXGen::fromArray( $data )
     ->setDefaultFont( 'Courier New' )
     ->setDefaultFontSize( 14 )
+    ->mergeCells('A13:B13')
     ->saveAs('styles_and_tags.xlsx');
 ```
 ![XLSX screenshot](styles.png)
@@ -76,15 +80,16 @@ SimpleXLSXGen::fromArray( $data )
 ### More examples
 ```php
 // Fluid interface, output to browser for download
-SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx');
+Shuchkin\SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx');
 
 // Fluid interface, multiple sheets
-SimpleXLSXGen::fromArray( $books )->addSheet( $books2 )->download();
+Shuchkin\SimpleXLSXGen::fromArray( $books )->addSheet( $books2 )->download();
 
 // Alternative interface, sheet name, get xlsx content
-$xlsx_cache = (string) (new SimpleXLSXGen)->addSheet( $books, 'Modern style');
+$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');
@@ -99,6 +104,7 @@ ini_set('display_errors', 1 );
 
 $data = [
     ['Debug', 123]
-]
-SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
+];
+
+Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
 ```

composer.json

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

license.md

@@ -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

src/SimpleXLSXGen.php

@@ -1,4 +1,6 @@
 <?php
+namespace Shuchkin;
+
 /**
  * Class SimpleXLSXGen
  * Export data to MS Excel. PHP XLSX generator
@@ -34,11 +36,10 @@ class SimpleXLSXGen {
     const A_RIGHT = 2;
     const A_CENTER = 3;
 
-
     public function __construct() {
         $this->curSheet = -1;
         $this->defaultFont = 'Calibri';
-		$this->sheets = [ ['name' => 'Sheet1', 'rows' => [], 'hyperlinks' => [] ] ];
+        $this->sheets = [ ['name' => 'Sheet1', 'rows' => [], 'hyperlinks' => [], 'mergecells' => [] ] ];
         $this->SI = [];		// sharedStrings index
         $this->SI_KEYS = []; //  & keys
         $this->F = [ self::F_NORMAL ]; // fonts
@@ -71,7 +72,7 @@ class SimpleXLSXGen {
             'xl/worksheets/sheet1.xml' => '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"
     xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
-><dimension ref="{REF}"/>{COLS}<sheetData>{ROWS}</sheetData>{HYPERLINKS}</worksheet>',
+><dimension ref="{REF}"/>{COLS}<sheetData>{ROWS}</sheetData>{MERGECELLS}{HYPERLINKS}</worksheet>',
             'xl/worksheets/_rels/sheet1.xml.rels' => '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">{HYPERLINKS}</Relationships>',
             'xl/sharedStrings.xml' => '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
@@ -110,8 +111,7 @@ class SimpleXLSXGen {
         // <si><t>Простой шаблон</t></si><si><t>Будем делать генератор</t></si>
     }
     public static function fromArray( array $rows, $sheetName = null ) {
-		$xlsx = new static();
-		return $xlsx->addSheet( $rows, $sheetName );
+        return (new static())->addSheet( $rows, $sheetName );
     }
 
     public function addSheet( array $rows, $name = null ) {
@@ -120,12 +120,17 @@ class SimpleXLSXGen {
         if ( $name === null ) { // autogenerated sheet names
             $name = 'Sheet'.($this->curSheet+1);
         } else {
+            $name = mb_substr($name, 0, 31);
             $names = [];
             foreach( $this->sheets as $sh ) {
                 $names[ mb_strtoupper( $sh['name']) ] = 1;
             }
             for( $i = 0; $i < 100; $i++ ) {
-				$new_name = ($i === 0) ? $name : $name .' ('.$i.')';
+                $postfix = ' ('.$i.')';
+                $new_name = ($i === 0) ? $name : $name . $postfix;
+                if (mb_strlen($new_name) > 31) {
+                    $new_name = mb_substr($name,0, 31-mb_strlen($postfix)) . $postfix;
+                }
                 $NEW_NAME = mb_strtoupper( $new_name );
                 if ( !isset( $names[ $NEW_NAME ]) ) {
                     $name = $new_name;
@@ -134,9 +139,9 @@ class SimpleXLSXGen {
             }
         }
 
-		$this->sheets[$this->curSheet] = ['name' => $name, 'hyperlinks' => []];
+        $this->sheets[$this->curSheet] = ['name' => $name, 'hyperlinks' => [], 'mergecells' => []];
 
-		if ( is_array( $rows ) && isset( $rows[0] ) && is_array($rows[0]) ) {
+        if ( isset( $rows[0] ) && is_array($rows[0]) ) {
             $this->sheets[$this->curSheet]['rows'] = $rows;
         } else {
             $this->sheets[$this->curSheet]['rows'] = [];
@@ -435,12 +440,13 @@ class SimpleXLSXGen {
                     if ( !isset($COL[ $CUR_COL ])) {
                         $COL[ $CUR_COL ] = 0;
                     }
+                    $cname = $this->num2name($CUR_COL) . $CUR_ROW;
+
                     if ( $v === null || $v === '' ) {
+                        $row .= '<c r="'.$cname.'"/>';
                         continue;
                     }
 
-					$cname = $this->num2name($CUR_COL) . $CUR_ROW;
-
                     $ct = $cv = null;
                     $N = $F = $A = 0;
 
@@ -511,7 +517,7 @@ class SimpleXLSXGen {
                                 $N = self::N_TIME; // time
                             } elseif ( preg_match( '/^(\d\d\d\d)-(\d\d)-(\d\d) (\d\d):(\d\d):(\d\d)$/', $v, $m ) ) {
                                 $cv = $this->date2excel( $m[1], $m[2], $m[3], $m[4], $m[5], $m[6] );
-								$N = self::N_DATETIME; // [22] m/d/yy h:mm
+                                $N = ((int) $m[1] === 0) ? self::N_TIME : self::N_DATETIME; // [22] m/d/yy h:mm
                             } elseif ( preg_match( '/^(\d\d)\/(\d\d)\/(\d\d\d\d) (\d\d):(\d\d):(\d\d)$/', $v, $m ) ) {
                                 $cv = $this->date2excel( $m[3], $m[2], $m[1], $m[4], $m[5], $m[6] );
                                 $N = self::N_DATETIME; // [22] m/d/yy h:mm
@@ -525,6 +531,10 @@ class SimpleXLSXGen {
                                 $this->sheets[ $idx ]['hyperlinks'][] = ['ID' => 'rId' . ( count( $this->sheets[ $idx ]['hyperlinks'] ) + 1 ), 'R' => $cname, 'H' => 'mailto:' . $v, 'L' => ''];
                                 $F = self::F_HYPERLINK; // Hyperlink
                             }
+                            if ( ($N === self::N_DATE || $N === self::N_DATETIME) && $cv < 0 ) {
+                                $cv = null;
+                                $N = 0;
+                            }
                         }
                         if ( !$cv) {
 
@@ -553,9 +563,9 @@ class SimpleXLSXGen {
                     } elseif ( is_float( $v ) ) {
                         $vl = mb_strlen( (string) $v );
                         $cv = $v;
-					} elseif ( $v instanceof DateTime ) {
+                    } elseif ( $v instanceof \DateTime ) {
                         $vl = 16;
-						$cv = $this->date2excel( $v->format('Y'), $v->format('m'), $v->format('d'), $v->format('H'), $v->format('i'), $v->format('s') );
+                        $cv = $this->date2excel($v->format('Y'), $v->format('m'), $v->format('d'), $v->format('H'), $v->format('i'), $v->format('s'));
                         $N = self::N_DATETIME; // [22] m/d/yy h:mm
                     } else {
                         continue;
@@ -584,8 +594,8 @@ class SimpleXLSXGen {
                         }
                     }
 
-					$row .= '<c r="' . $cname . '"'.($ct ? ' t="'.$ct.'"' : '').($cs ? ' s="'.$cs.'"' : '').'>'
-					        .($ct === 'inlineStr' ? '<is><t>'.$cv.'</t></is>' : '<v>' . $cv . '</v>')."</c>\r\n";
+                    $row .= '<c r="' . $cname . '"' . ($ct ? ' t="' . $ct . '"' : '') . ($cs ? ' s="' . $cs . '"' : '') . '>'
+                            . ($ct === 'inlineStr' ? '<is><t>' . $cv . '</t></is>' : '<v>' . $cv . '</v>') . "</c>\r\n";
                 }
                 $ROWS[] = $row . "</row>\r\n";
             }
@@ -593,11 +603,22 @@ class SimpleXLSXGen {
                 $COLS[] = '<col min="'.$k.'" max="'.$k.'" width="'.min( $max+1, 60).'" />';
             }
             $COLS[] = '</cols>';
-			$REF = 'A1:'.$this->num2name(count($COLS)) . $CUR_ROW;
+            $REF = 'A1:'.$this->num2name(count($COL)) . $CUR_ROW;
         } else {
             $ROWS[] = '<row r="1"><c r="A1" t="s"><v>0</v></c></row>';
             $REF = 'A1:A1';
         }
+
+        $MERGECELLS = [];
+        if ( count($this->sheets[$idx]['mergecells']) ) {
+            $MERGECELLS[] = '';
+            $MERGECELLS[] = '<mergeCells count="'.count($this->sheets[$idx]['mergecells']).'">';
+            foreach( $this->sheets[$idx]['mergecells'] as $m ) {
+                $MERGECELLS[] = '<mergeCell ref="'.$m.'"/>';
+            }
+            $MERGECELLS[] = '</mergeCells>';
+        }
+
         $HYPERLINKS = [];
         if ( count( $this->sheets[$idx]['hyperlinks']) ) {
             $HYPERLINKS[] = '<hyperlinks>';
@@ -609,8 +630,8 @@ class SimpleXLSXGen {
         //restore locale
         setlocale(LC_NUMERIC, $_loc);
 
-		return str_replace(['{REF}','{COLS}','{ROWS}','{HYPERLINKS}'],
-			[ $REF, implode("\r\n", $COLS), implode("\r\n",$ROWS), implode("\r\n", $HYPERLINKS) ],
+        return str_replace(['{REF}','{COLS}','{ROWS}','{MERGECELLS}','{HYPERLINKS}'],
+            [ $REF, implode("\r\n", $COLS), implode("\r\n",$ROWS), implode("\r\n", $MERGECELLS), implode("\r\n", $HYPERLINKS) ],
             $template );
     }
 
@@ -625,15 +646,16 @@ class SimpleXLSXGen {
     }
 
     public function date2excel($year, $month, $day, $hours=0, $minutes=0, $seconds=0) {
+
         $excelTime = (($hours * 3600) + ($minutes * 60) + $seconds) / 86400;
 
-	    if ( $year === 0 ) {
+        if ( (int) $year === 0 ) {
             return $excelTime;
         }
 
         // self::CALENDAR_WINDOWS_1900
         $excel1900isLeapYear = True;
-		if (((int)$year === 1900) && ($month <= 2)) { $excel1900isLeapYear = False; }
+        if (($year === 1900) && ($month <= 2)) { $excel1900isLeapYear = False; }
         $myExcelBaseDate = 2415020;
 
         // Julian base date Adjustment
@@ -643,9 +665,9 @@ class SimpleXLSXGen {
             $month += 9;
             --$year;
         }
-		//    Calculate the Julian Date, then subtract the Excel base date (JD 2415020 = 31-Dec-1899 Giving Excel Date of 0)
         $century = substr($year,0,2);
         $decade = substr($year,2,2);
+        //    Calculate the Julian Date, then subtract the Excel base date (JD 2415020 = 31-Dec-1899 Giving Excel Date of 0)
         $excelDate = floor((146097 * $century) / 4) + floor((1461 * $decade) / 4) + floor((153 * $month + 2) / 5) + $day + 1721119 - $myExcelBaseDate + $excel1900isLeapYear;
 
         return (float) $excelDate + $excelTime;
@@ -658,6 +680,10 @@ class SimpleXLSXGen {
         $this->defaultFontSize = $size;
         return $this;
     }
+    public function mergeCells( $range ) {
+        $this->sheets[$this->curSheet]['mergecells'][] = $range;
+        return $this;
+    }
     public function esc( $str ) {
         // XML UTF-8: #x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF]
         // but we use fast version