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.

Overview

Version 7.0 upgrades the underlying persistence stack to byjg/micro-orm 7.0 and byjg/anydataset-db 7.0. UsersService, UsersRepository, UserPropertiesRepository, models and mapper interfaces keep the same signatures as 6.x; the only API change is the renaming of the UserField enum cases to PascalCase (see below).

Since 6.0 the library was already wired exclusively through DatabaseExecutor — the API that became mandatory in anydataset-db 7.0 — so apart from that rename, the library code changed only to fix the user id conversion in UserPropertiesRepository (see Bug Fixes).

Breaking Changes

Dependencies

Package	6.x	7.0
byjg/micro-orm	^6.0	^7.0
byjg/anydataset-db (transitive)	^6.0	^7.0

Removed driver query methods (via anydataset-db 7.0)

The query methods deprecated on the drivers since anydataset-db 6.0 no longer exist ($dbDriver->execute(), getIterator(), getScalar(), executeAndGetId(), getAllFields()). If your application still calls them on the driver instance it passes to AuthUser, migrate to:

<?php
use ByJG\AnyDataset\Db\DatabaseExecutor;

$executor = DatabaseExecutor::using($dbDriver);
$executor->execute($sql, $params);

The recommended wiring is unchanged and keeps working as-is:

<?php
$dbDriver = Factory::getDbInstance('mysql://user:pass@host/db');
$executor = DatabaseExecutor::using($dbDriver);

$usersRepository = new UsersRepository($executor, UserModel::class);
$propertiesRepository = new UserPropertiesRepository($executor, UserPropertiesModel::class);
$service = new UsersService($usersRepository, $propertiesRepository, LoginField::Username);

Observer system (via micro-orm 7.0)

micro-orm 7.0 removed the global ORMSubject singleton and rewired observers on top of the DatabaseExecutor observer mechanism. AuthUser does not use observers internally, but if your application registered observers on the AuthUser repositories, review the micro-orm 7.0 changelog: observers are now scoped per executor instead of global.

Development dependencies

• PHPUnit: ^10.5|^11.5 → ^12.5
• Psalm: vimeo/psalm ^5.9|^6.13 → psalm/phar ^6.16

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)
UserField	Created_at, uUpdated_at, Deleted_at	CreatedAt, UpdatedAt, DeletedAt

Not a plain change of casing: UserField::uUpdated_at is now UserField::UpdatedAt.

Bug Fixes

• UserPropertiesRepository converted the user id for its queries without the database at hand (getUpdateFunctionValue($userid, null)), so a UUID user id was always written as X'…'. With byjg/micro-orm 7.0, which writes a UUID in the syntax of each database, the repository now passes its executor, and the queries work on PostgreSQL (a native uuid) and SQL Server too.
• SessionContext::registerLogin($userId, $data) lost $data: it stored the cache item in place of the array, so getSessionData() never found the values passed at login.

Migration from 6.x

1. Update the composer constraint:

{
  "require": {
    "byjg/authuser": "^7.0"
  }
}

2. If your application already wires AuthUser through DatabaseExecutor::using() (the documented pattern since 6.0), no code changes are required.
3. If you still call the removed query methods directly on the DbDriverInterface instance, migrate those calls to DatabaseExecutor (see table in the anydataset-db 7.0 changelog).

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/cache-engine is now ^7.0.
• byjg/jwt-wrapper is now ^7.0.
• byjg/micro-orm 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.
• The root example.php script was removed; see the Examples page.