Changelog - Version 7.0

Status: in development. This document tracks changes landing on the 7.0 branch. Nothing here is released yet, and the contents may still change.

Breaking Changes

Enum cases renamed to PascalCase

Enum cases follow the ByJG standard and are written in PascalCase. The backed values did not change, so ->value, from(), tryFrom() and stored data are not affected; only code that names a case (or reads ->name) has to be updated.

Enum	Before (6.x)	After (7.0)
Relation	EQUAL, LESS_THAN, GREATER_THAN, LESS_OR_EQUAL_THAN, GREATER_OR_EQUAL_THAN, NOT_EQUAL, STARTS_WITH, CONTAINS, IN, NOT_IN, IS_NULL, IS_NOT_NULL	Equal, LessThan, GreaterThan, LessThanOrEqualTo, GreaterThanOrEqualTo, NotEqual, StartsWith, Contains, In, NotIn, IsNull, IsNotNull

Not a plain change of casing: Relation::LESS_OR_EQUAL_THAN is now Relation::LessThanOrEqualTo; Relation::GREATER_OR_EQUAL_THAN is now Relation::GreaterThanOrEqualTo.

Removed: IteratorFilter::addRelation() and addRelationOr()

Deprecated since 5.0. They were aliases: use and() and or(), which take the same arguments.

// Before
$filter->addRelation('field', Relation::Equal, 'value');
$filter->addRelationOr('field2', Relation::GreaterThan, 10);
// After
$filter->and('field', Relation::Equal, 'value');
$filter->or('field2', Relation::GreaterThan, 10);

Bug Fixes

• AnyDataset::removeRow() with an index of 2 or more also dropped rows after it (removing index 2 of a, b, c, d left a, b), and never moved the current row, so a later addField() or removeRow() hit the wrong row or a missing index. It now removes only that row; the current row keeps pointing at the same row, or at the previous one when it is the one removed. An index out of range is ignored.

Requirements

• PHP 8.3, 8.4, 8.5 and 8.6 are now supported: "php": ">=8.3 <8.7". The previous <8.6 upper bound excluded PHP 8.6, since <8.6 is exclusive.

ByJG dependencies

• byjg/serializer is now ^7.0.
• byjg/xmlutil is now ^7.0.

While 7.0 is unreleased these resolve to 7.0.x-dev from each component's 7.0 branch, via minimum-stability: dev with prefer-stable: true.

Toolchain

• PHPUnit updated to ^12.5.

• Psalm is installed as psalm/phar instead of vimeo/psalm.

  vimeo/psalm lists the PHP versions it supports and no published release includes 8.6, so as a dev dependency it made composer install fail on the 8.6 build job before any test ran. psalm/phar requires only php ^8.2 and bundles its own dependencies, so it installs on every PHP version in the matrix and cannot conflict with the project's. Psalm itself still refuses to run on 8.6, which is why the Psalm job uses 8.5. composer psalm runs it.

• PHPUnit 13 is deliberately not used. It requires PHP >=8.4.1, breaking the 8.3 floor.

Continuous Integration

• The build matrix now includes PHP 8.6.
• The Psalm job runs on PHP 8.5.

Housekeeping

• phpunit.xml.dist renamed to phpunit.xml.
• Documentation pages renamed to kebab-case: docs/iteratorfilter.md → docs/iterator-filter.md, docs/rowoutput.md → docs/row-output.md and docs/rowvalidator.md → docs/row-validator.md. Links to the old pages have to be updated: the published URLs change too (e.g. /docs/php/anydataset/iteratorfilter is now /docs/php/anydataset/iterator-filter), with no redirect.