You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
Потоковое чтение 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.