1.17.1

Added

• Implementation of the Excel AVERAGEIFS() functions as part of a restructuring of Database functions and Conditional Statistical functions.
• Support for date values and percentages in query parameters for Database functions, and the IF expressions in functions like COUNTIF() and AVERAGEIF(). #1875
• Support for booleans, and for wildcard text search in query parameters for Database functions, and the IF expressions in functions like COUNTIF() and AVERAGEIF(). #1876
• Implemented DataBar for conditional formatting in Xlsx, providing read/write and creation of (type, value, direction, fills, border, axis position, color settings) as DataBar options in Excel. #1754
• Alignment for ODS Writer #1796
• Basic implementation of the PERMUTATIONA() Statistical Function

Changed

• Formula functions that previously called PHP functions directly are now processed through the Excel Functions classes; resolving issues with PHP8 stricter typing. #1789

  The following MathTrig functions are affected:
  ABS(), ACOS(), ACOSH(), ASIN(), ASINH(), ATAN(), ATANH(),
  COS(), COSH(), DEGREES() (rad2deg), EXP(), LN() (log), LOG10(),
  RADIANS() (deg2rad), SIN(), SINH(), SQRT(), TAN(), TANH().

  One TextData function is also affected: REPT() (str_repeat).

• formatAsDate correctly matches language metadata, reverting c55272e

• Formulae that previously crashed on sub function call returning excel error value now return said value.
  The following functions are affected CUMPRINC(), CUMIPMT(), AMORLINC(),
  AMORDEGRC().

• Adapt some function error return value to match excel's error.
  The following functions are affected PPMT(), IPMT().

Deprecated

• Calling many of the Excel formula functions directly rather than through the Calculation Engine.

  The logic for these Functions is now being moved out of the categorised Database, DateTime, Engineering, Financial, Logical, LookupRef, MathTrig, Statistical, TextData and Web classes into small, dedicated classes for individual functions or related groups of functions.

  This makes the logic in these classes easier to maintain; and will reduce the memory footprint required to execute formulae when calling these functions.

Removed

• Nothing.

Fixed

• Avoid Duplicate Titles When Reading Multiple HTML Files.Issue #1823 PR #1829
• Fixed issue with Worksheet's getCell() method when trying to get a cell by defined name. #1858
• Fix possible endless loop in NumberFormat Masks #1792
• Fix problem resulting from literal dot inside quotes in number format masks. PR #1830
• Resolve Google Sheets Xlsx charts issue. Google Sheets uses oneCellAnchor positioning and does not include *Cache values in the exported Xlsx. PR #1761
• Fix for Xlsx Chart axis titles mapping to correct X or Y axis label when only one is present. PR #1760
• Fix For Null Exception on ODS Read of Page Settings. #1772
• Fix Xlsx reader overriding manually set number format with builtin number format. PR #1805
• Fix Xlsx reader cell alignment. PR #1710
• Fix for not yet implemented data-types in Open Document writer Issue #1674
• Fix XLSX reader when having a corrupt numeric cell data type PR #1664
• Fix on CUMPRINC(), CUMIPMT(), AMORLINC(), AMORDEGRC() usage. When those functions called one of YEARFRAC(), PPMT(), IPMT() and they would get back an error value (represented as a string), trying to use numeral operands (+, /, -, *) on said return value and a number (float or int`) would fail.

1.17.0

Added

• Implementation of the Excel AVERAGEIFS() functions as part of a restructuring of Database functions and Conditional Statistical functions.
• Support for date values and percentages in query parameters for Database functions, and the IF expressions in functions like COUNTIF() and AVERAGEIF(). #1875
• Support for booleans, and for wildcard text search in query parameters for Database functions, and the IF expressions in functions like COUNTIF() and AVERAGEIF(). #1876
• Implemented DataBar for conditional formatting in Xlsx, providing read/write and creation of (type, value, direction, fills, border, axis position, color settings) as DataBar options in Excel. #1754
• Alignment for ODS Writer #1796
• Basic implementation of the PERMUTATIONA() Statistical Function

Changed

• Formula functions that previously called PHP functions directly are now processed through the Excel Functions classes; resolving issues with PHP8 stricter typing. #1789

  The following MathTrig functions are affected:
  ABS(), ACOS(), ACOSH(), ASIN(), ASINH(), ATAN(), ATANH(),
  COS(), COSH(), DEGREES() (rad2deg), EXP(), LN() (log), LOG10(),
  RADIANS() (deg2rad), SIN(), SINH(), SQRT(), TAN(), TANH().

  One TextData function is also affected: REPT() (str_repeat).

• formatAsDate correctly matches language metadata, reverting c55272e

• Formulae that previously crashed on sub function call returning excel error value now return said value.
  The following functions are affected CUMPRINC(), CUMIPMT(), AMORLINC(),
  AMORDEGRC().

• Adapt some function error return value to match excel's error.
  The following functions are affected PPMT(), IPMT().

Deprecated

• Calling many of the Excel formula functions directly rather than through the Calculation Engine.

  The logic for these Functions is now being moved out of the categorised Database, DateTime, Engineering, Financial, Logical, LookupRef, MathTrig, Statistical, TextData and Web classes into small, dedicated classes for individual functions or related groups of functions.

  This makes the logic in these classes easier to maintain; and will reduce the memory footprint required to execute formulae when calling these functions.

Removed

• Nothing.

Fixed

• Avoid Duplicate Titles When Reading Multiple HTML Files.Issue #1823 PR #1829
• Fixed issue with Worksheet's getCell() method when trying to get a cell by defined name. #1858
• Fix possible endless loop in NumberFormat Masks #1792
• Fix problem resulting from literal dot inside quotes in number format masks. PR #1830
• Resolve Google Sheets Xlsx charts issue. Google Sheets uses oneCellAnchor positioning and does not include *Cache values in the exported Xlsx. PR #1761
• Fix for Xlsx Chart axis titles mapping to correct X or Y axis label when only one is present. PR #1760
• Fix For Null Exception on ODS Read of Page Settings. #1772
• Fix Xlsx reader overriding manually set number format with builtin number format. PR #1805
• Fix Xlsx reader cell alignment. PR #1710
• Fix for not yet implemented data-types in Open Document writer Issue #1674
• Fix XLSX reader when having a corrupt numeric cell data type PR #1664
• Fix on CUMPRINC(), CUMIPMT(), AMORLINC(), AMORDEGRC() usage. When those functions called one of YEARFRAC(), PPMT(), IPMT() and they would get back an error value (represented as a string), trying to use numeral operands (+, /, -, *) on said return value and a number (float or int`) would fail.

1.16.0

Added

• CSV Reader - Best Guess for Encoding, and Handle Null-string Escape #1647

Changed

• Updated the CONVERT() function to support all current MS Excel categories and Units of Measure.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• Fix for Xls Reader when SST has a bad length #1592
• Resolve Xlsx loader issue whe hyperlinks don't have a destination
• Resolve issues when printer settings resources IDs clash with drawing IDs
• Resolve issue with SLK long filenames #1612
• ROUNDUP and ROUNDDOWN return incorrect results for values of 0 #1627
• Apply Column and Row Styles to Existing Cells #1712 PR #1721
• Resolve issues with defined names where worksheet doesn't exist (#1686)[https://github.com//issues/1686] and #1723 - PR #1742
• Fix for issue #1735 Incorrect activeSheetIndex after RemoveSheetByIndex - PR #1743
• Ensure that the list of shared formulae is maintained when an xlsx file is chunked with readFilterIssue #169.
• Fix for notice during accessing "cached magnification factor" offset #1354
• Fix compatibility with ext-gd on php 8

Security Fix (CVE-2020-7776)

• Prevent XSS through cell comments in the HTML Writer.

1.15.0

Added

• Implemented Page Order for Xlsx and Xls Readers, and provided Page Settings (Orientation, Scale, Horizontal/Vertical Centering, Page Order, Margins) support for Ods, Gnumeric and Xls Readers #1559
• Implementation of the Excel LOGNORM.DIST(), NORM.S.DIST(), GAMMA() and GAUSS() functions. #1588
• Named formula implementation, and improved handling of Defined Names generally #1535
  • Defined Names are now case-insensitive
  • Distinction between named ranges and named formulae
  • Correct handling of union and intersection operators in named ranges
  • Correct evaluation of named range operators in calculations
  • fix resolution of relative named range values in the calculation engine; previously all named range values had been treated as absolute.
  • Calculation support for named formulae
  • Support for nested ranges and formulae (named ranges and formulae that reference other named ranges/formulae) in calculations
  • Introduction of a helper to convert address formats between R1C1 and A1 (and the reverse)
  • Proper support for both named ranges and named formulae in all appropriate Readers
    • Xlsx (Previously only simple named ranges were supported)
    • Xls (Previously only simple named ranges were supported)
    • Gnumeric (Previously neither named ranges nor formulae were supported)
    • Ods (Previously neither named ranges nor formulae were supported)
    • Xml (Previously neither named ranges nor formulae were supported)
  • Proper support for named ranges and named formulae in all appropriate Writers
    • Xlsx (Previously only simple named ranges were supported)
    • Xls (Previously neither named ranges nor formulae were supported) - Still not supported, but some parser issues resolved that previously failed to differentiate between a defined name and a function name
    • Ods (Previously neither named ranges nor formulae were supported)
• Support for PHP 8.0

Changed

• Improve Coverage for ODS Reader #1545
• Named formula implementation, and improved handling of Defined Names generally #1535
• fix resolution of relative named range values in the calculation engine; previously all named range values had been treated as absolute.
• Drop $this->spreadSheet null check from Xlsx Writer #1646
• Improving Coverage for Excel2003 XML Reader #1557

Deprecated

• IMPORTANT NOTE: This Introduces a BC break in the handling of named ranges. Previously, a named range cell reference of B2 would be treated identically to a named range cell reference of $B2 or B$2 or $B$2 because the calculation engine treated then all as absolute references. These changes "fix" that, so the calculation engine now handles relative references in named ranges correctly.
  This change that resolves previously incorrect behaviour in the calculation may affect users who have dynamically defined named ranges using relative references when they should have used absolute references.

Removed

• Nothing.

Fixed

• PrintArea causes exception #1544
• Calculation/DateTime Failure With PHP8 #1661
• Reader/Gnumeric Failure with PHP8 #1662
• ReverseSort bug, exposed but not caused by PHP8 #1660
• Bug setting Superscript/Subscript to false #1567

1.14.1

Added

• nothing

Fixed

• WEBSERVICE is HTTP client agnostic and must be configured via Settings::setHttpClient() #1562
• Borders were not complete on rowspanned columns using HTML reader #1473

Changed

• nothing

1.14.0

Added

• Add support for IFS() logical function #1442
• Add Cell Address Helper to provide conversions between the R1C1 and A1 address formats #1558
• Add ability to edit Html/Pdf before saving #1499
• Add ability to set codepage explicitly for BIFF5 #1018
• Added support for the WEBSERVICE function #1409

Fixed

• Resolve evaluation of utf-8 named ranges in calculation engine #1522
• Fix HLOOKUP on single row #1512
• Fix MATCH when comparing different numeric types #1521
• Fix exact MATCH on ranges with empty cells #1520
• Fix for Issue #1516 (Cloning worksheet makes corrupted Xlsx) #1530
• Fix For Issue #1509 (Can not set empty enclosure for CSV) #1518
• Fix for Issue #1505 (TypeError : Argument 4 passed to PhpOffice\PhpSpreadsheet\Writer\Xlsx\Worksheet::writeAttributeIf() must be of the type string) #1525
• Fix for Issue #1495 (Sheet index being changed when multiple sheets are used in formula) #1500
• Fix for Issue #1533 (A reference to a cell containing a string starting with "#" leads to errors in the generated xlsx.) #1534
• Xls Writer - Correct Timestamp Bug #1493
• Don't ouput row and columns without any cells in HTML writer #1235

1.13.0

Added

• Support writing to streams in all writers #1292
• Support CSV files with data wrapping a lot of lines #1468
• Support protection of worksheet by a specific hash algorithm #1485

Fixed

• Fix Chart samples by updating chart parameter from 0 to DataSeries::EMPTY_AS_GAP #1448
• Fix return type in docblock for the Cells::get() #1398
• Fix RATE, PRICE, XIRR, and XNPV Functions #1456
• Save Excel 2010+ functions properly in XLSX #1461
• Several improvements in HTML writer #1464
• Fix incorrect behaviour when saving XLSX file with drawings #1462,
• Fix Crash while trying setting a cell the value "123456\n" #1476
• Improved DATEDIF() function and reduced errors for Y and YM units #1466
• Stricter typing for mergeCells #1494

Changed

• Drop support for PHP 7.1, according to https://phpspreadsheet.readthedocs.io/en/latest/#php-version-support
• Drop partial migration tool in favor of complete migration via RectorPHP #1445
• Limit composer package to src/ #1424

1.12.0

Added

• Improved the ARABIC function to also handle short-hand roman numerals
• Added support for the FLOOR.MATH and FLOOR.PRECISE functions #1351

Fixed

• Fix ROUNDUP and ROUNDDOWN for floating-point rounding error #1404
• Fix ROUNDUP and ROUNDDOWN for negative number #1417
• Fix loading styles from vmlDrawings when containing whitespace #1347
• Fix incorrect behavior when removing last row #1365
• MATCH with a static array should return the position of the found value based on the values submitted #1332
• Fix Xlsx Reader's handling of undefined fill color #1353

1.11.0

Added

• Added support for the BASE function
• Added support for the ARABIC function
• Conditionals - Extend Support for (NOT)CONTAINSBLANKS #1278

Fixed

• Handle Error in Formula Processing Better for Xls #1267
• Handle ConditionalStyle NumberFormat When Reading Xlsx File #1296
• Fix Xlsx Writer's handling of decimal commas #1282
• Fix for issue by removing test code mistakenly left in #1328
• Fix for Xls writer wrong selected cells and active sheet #1256
• Fix active cell when freeze pane is used #1323
• Fix XLSX file loading with autofilter containing '$' #1326
• PHPDoc - Use @return $this for fluent methods #1362

1.10.1

Changed

• PHP 7.4 compatibility

Fixed

• FLOOR() function accept negative number and negative significance #1245
• Correct column style even when using rowspan #1249
• Do not confuse defined names and cell refs #1263
• XLSX reader/writer keep decimal for floats with a zero decimal part #1262
• ODS writer prevent invalid numeric value if locale decimal separator is comma #1268
• Xlsx writer actually writes plotVisOnly and dispBlanksAs from chart properties #1266