A seeder fills reference or bootstrap data - the permission catalogue, the
built-in roles, the first administrator. It is not a migration: it never
touches the schema, it runs on demand, and it must be safe to run twice.
- Seeder: the contract (name + run).
- AbstractSeeder: seedOnce() inserts only when the criteria match nothing and
records inserted/skipped counts. It never overwrites a row a user edited.
- SeederRunner: runs an ordered batch inside one transaction, so a failing
seeder leaves the database untouched. Supports running a named subset.
- SeederResult: per-seeder outcome for reporting.
- ConfigurationException::unknownSeeder() lists the registered names.
docs/SEEDING.md documents the contract and how to write one.
Drop support for PHP 8.3 and lower. The package now declares >=8.4, and CI runs
only on 8.4.
- composer.json: require php >=8.4.
- mago.toml: php-version = "8.4", matching the minimum supported version.
- phpstan.neon: phpVersion 80400.
- Upgrade phpstan/phpstan to ^2.3: 1.x cannot parse `new Foo()->bar()`, which the
8.4 formatter now emits.
- Fix the type errors PHPStan 2 reports: class-string<static> variance,
optional array offsets in fromEnvironment, list vs array for PdoConnection::$lru,
ReflectionClass<Model> docblocks, Repository made covariant in T, and a redundant
null comparison in validateRelationPath.
- CI: single PHP 8.4 job using the php:8.4-cli container instead of setup-php,
which failed with a TLS handshake timeout on the runner.
BREAKING CHANGE: PHP 8.4 is now required.
Attribute-mapped Active Record ORM for MariaDB/MySQL over PDO.
- Attribute-driven metadata: TableName, PrimaryKey, AutoIncrement, Column,
Guarded, Ignore, Required, Enum, Nullable, Length, Precision, Unique,
UniqueGroup, Index, MaxLength.
- Relationship mapping: BelongsTo, HasOne, HasMany, BelongsToMany with
batched eager loading and a 3-level depth limit.
- Orm entry point with fromArray, fromPdo, fromEnv and nested transactions.
- Immutable Query with Cond operators and GroupCond grouping.
- Repository read and write API, pagination, and typed exception hierarchy.
- Declares PHP >=8.3; Mago and PHPStan pin the parser to 8.3.
- MIT license.