Skip to content

v5.0.0

Latest

Choose a tag to compare

@aVadim483 aVadim483 released this 13 Nov 14:42

Added

  • Streaming ODS books/sheets with shared reading APIs, repeated rows/cells, merged
    ranges, typed values and cached formula results. Dates without a timezone use UTC;
    raw dates and durations retain ISO text. Full ODS styles/images/formula text are deferred.
  • Verified reading of Excel-saved XLSM, XLTX and XLTM through the XLSX reader, including
    VBA-bearing fixtures. Macros are never executed and formulas are not calculated.
  • Workbook close()/isClosed(), owned temporary-file cleanup and a reproducible
    heap/temp-disk benchmark in tools/benchmark-reader.php.

Fixed

  • ZIP-backed XML readers use the archive-stream fallback for paths containing
    #, % or ?, avoiding ambiguous zip:// URIs that can fail during reading.
  • ODS row limits stop the iterator before converting the next row run. Invalid
    values beyond the limit no longer cause an otherwise completed read to fail;
    repeated rows obey the same limit.

Migration verification

  • An isolated Composer consumer was migrated from 4.5.0 to development snapshot
    561abac on Windows/PHP 8.4.19. All 51 recorded scenario results matched strictly;
    another 27 ODS/resource-ownership checks passed. See UPGRADE.md for coverage and limits.

Breaking changes

  • Excel is now an opening facade; XML workbooks are Xlsx\XlsxBook. Migrate new Excel(),
    Excel type hints and subclasses as described in UPGRADE.md.
  • openCsv() returns CsvBook. Use openCsvReader() to retain the low-level engine.
  • isXlsx() checks supported XML workbook parts/content types instead of any ZIP signature.
    ODS uses isOds()/openOds(); XLSB is rejected explicitly.
  • Closing a book is irreversible; new reads and resuming suspended iterators throw.
    PHP >=7.4 remains supported.

Migration guide


Русский

Добавлено

  • Потоковое чтение ODS через общий API: повторы строк/ячеек, объединения,
    типизированные значения и сохранённые результаты формул. Даты без пояса используют
    UTC; исходные даты и длительности сохраняют ISO-текст. Полные стили, изображения
    и текст формул ODS отложены.
  • Проверено чтение пересохранённых Excel файлов XLSM, XLTX и XLTM через XLSX-ридер,
    включая фикстуры с VBA-проектом. Макросы не выполняются, формулы не вычисляются.
  • close()/isClosed() книги, удаление собственных временных файлов и воспроизводимый
    замер памяти PHP/временного диска в tools/benchmark-reader.php.

Исправлено

  • XML-ридеры ZIP-книг используют чтение через поток архива для путей с #, %
    или ?, избегая неоднозначных URI zip://, которые могут вызвать сбой при чтении.
  • При достижении лимита строк ODS итератор завершается до преобразования следующего
    блока строк. Некорректные значения за пределами лимита больше не вызывают ошибку
    уже завершённого чтения; лимит также соблюдается для повторяющихся строк.

Проверка миграции

  • Изолированный потребительский проект с Composer переведён с 4.5.0 на снимок
    разработки 561abac под Windows/PHP 8.4.19. Результаты всех 51 сохранённого сценария
    строго совпали; дополнительно пройдены 27 проверок ODS и управления ресурсами.
    Охват и ограничения проверки описаны в UPGRADE.ru.md.

Изменения совместимости

  • Excel стал фасадом открытия; XML-книги представлены Xlsx\XlsxBook. Замены
    new Excel(), типов и наследников описаны в UPGRADE.ru.md.
  • openCsv() возвращает CsvBook; для низкоуровневого движка используйте openCsvReader().
  • isXlsx() проверяет части и типы XML-книги вместо любой сигнатуры ZIP.
    Для ODS добавлены isOds()/openOds(); XLSB отклоняется с явным сообщением.
  • Закрытие необратимо; новое чтение и продолжение генератора вызывают исключение.
    Минимальная версия PHP остаётся 7.4.

Инструкция по миграции