NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #3359 most downloaded on Packagist
PHP DataMapper ORM and Data Modelling Engine
Latest stable
v2.18.1
Last release 1 months ago
02 Oct 2026
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 57 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
118 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Fix: keep children when a nullable collection is reordered by @roxblnfk in https://github.com/cycle/orm/pull/576
Full Changelog: https://github.com/cycle/orm/compare/v2.18.0...v2.18.1
Add RefersToMorphed relation for cyclic morphed references by @roxblnfk in https://github.com/cycle/orm/pull/570
Full Changelog: https://github.com/cycle/orm/compare/v2.17.0...v2.18.0
Support BackedEnum for discriminator values in STI by @roxblnfk in https://github.com/cycle/orm/pull/566
Your coding agent can read these notes before it upgrades. Set up the MCP server →
wrapWhere() from database 2.19 by @roxblnfk in https://github.com/cycle/orm/pull/567wrapWhere option to QueryScope by @roxblnfk in https://github.com/cycle/orm/pull/568Full Changelog: https://github.com/cycle/orm/compare/v2.16.2...v2.17.0
Fix embedded entities loading via BulkLoader by @roxblnfk in https://github.com/cycle/orm/pull/565
Full Changelog: https://github.com/cycle/orm/compare/v2.16.1...v2.16.2
Enhanced documentation in load options classes in 62ded837299beab7a15a9324c6bb9f0a76c4db45
Enhanced documentation in load options classes in 62ded837299beab7a15a9324c6bb9f0a76c4db45
Full Changelog: https://github.com/cycle/orm/compare/v2.16.0...v2.16.1
Allow json type to be a scalar in the default Typecast by @gam6itko in https://github.com/cycle/orm/pull/562
json type to be a scalar in the default Typecast by @gam6itko in https://github.com/cycle/orm/pull/562Select::cursor() by @roxblnfk in https://github.com/cycle/orm/pull/564Full Changelog: https://github.com/cycle/orm/compare/v2.15.0...v2.16.0
Support LoadOptions DTOs in BulkLoader::load() by @roxblnfk in https://github.com/cycle/orm/pull/559
BulkLoader::load() by @roxblnfk in https://github.com/cycle/orm/pull/559Full Changelog: https://github.com/cycle/orm/compare/v2.14.3...v2.15.0
Fix keys processing in BulkLoader by @roxblnfk in https://github.com/cycle/orm/pull/558
Full Changelog: https://github.com/cycle/orm/compare/v2.14.2...v2.14.3
Fix BulkLoader indexing with Stringable primary keys by @roxblnfk in https://github.com/cycle/orm/pull/557
Full Changelog: https://github.com/cycle/orm/compare/v2.14.1...v2.14.2
Now, for BelongsToMorphed relations, you can legally manually specify the morph_type column (without morph_id). This won't work if the entity is not n
Now, for BelongsToMorphed relations, you can legally manually specify the morph_type column (without morph_id). This won't work if the entity is not new and the relation was set to null in this EM transaction (in this case, all relation fields will be prioritized to null). https://github.com/cycle/orm/pull/556
Cycle ORM allowed some flexibility for the programmer. The recent fix that reset related fields broke some existing project codebases. To fix this, the old behavior was restored and supported with tests.
Even though this behavior is backed by tests, we still recommend not doing it this way for best practice reasons.
Full Changelog: https://github.com/cycle/orm/compare/v2.14.0...v2.14.1
Add options DTOs for Select::load() method by @roxblnfk in https://github.com/cycle/orm/pull/553
Select::load() method by @roxblnfk in https://github.com/cycle/orm/pull/553BelongsToMorphed not clearing morph type on null relation by @roxblnfk in https://github.com/cycle/orm/pull/555Full Changelog: https://github.com/cycle/orm/compare/v2.13.2...v2.14.0
Fix a bug when related fields were not filled in BelongsToMorphed by @roxblnfk in https://github.com/cycle/orm/pull/550
Full Changelog: https://github.com/cycle/orm/compare/v2.13.1...v2.13.2
Revert #491: a bug found in a side project
Revert #491: a bug found in a side project
Full Changelog: https://github.com/cycle/orm/compare/v2.13.0...v2.13.1
Add UnitOfWork::hasPendingChanges() method by @roxblnfk in https://github.com/cycle/orm/pull/548
UnitOfWork::hasPendingChanges() method by @roxblnfk in https://github.com/cycle/orm/pull/548orderBy to HasOne loader by @markinigor in https://github.com/cycle/orm/pull/487TEntity generics by @rincler in https://github.com/cycle/orm/pull/524Full Changelog: https://github.com/cycle/orm/compare/v2.12.3...v2.13.0
Handle empty entity collection in BulkLoader without throwing exception by @roxblnfk in https://github.com/cycle/orm/pull/543
Full Changelog: https://github.com/cycle/orm/compare/v2.12.2...v2.12.3
Fix columns mapping in BelongsToMorphedLoader by @roxblnfk in https://github.com/cycle/orm/pull/542
Full Changelog: https://github.com/cycle/orm/compare/v2.12.1...v2.12.2
Fix BelongsToMorphedLoader by @roxblnfk in https://github.com/cycle/orm/pull/541
Full Changelog: https://github.com/cycle/orm/compare/v2.12.0...v2.12.1
Add BelongsToMorphed loader by @roxblnfk in #537 Now you can load BelongsToMorphed relations using the Select::load() method.
Select::load() method.Full Changelog: https://github.com/cycle/orm/compare/v2.11.1...v2.12.0
Fix RefersTo relation by @roxblnfk in https://github.com/cycle/orm/pull/534
Full Changelog: https://github.com/cycle/orm/compare/v2.11.0...v2.11.1
Add unset behavior by @gam6itko in https://github.com/cycle/orm/pull/517
unset behavior by @gam6itko in https://github.com/cycle/orm/pull/517groupByToDeduplicate feature by @gam6itko in https://github.com/cycle/orm/pull/528ignoreUninitializedRelations option to false by default by @roxblnfk in https://github.com/cycle/orm/pull/530Full Changelog: https://github.com/cycle/orm/compare/v2.10.1...v2.11.0
Add unset behavior by @gam6itko and @roxblnfk in https://github.com/cycle/orm/pull/517
unset behavior by @gam6itko and @roxblnfk in https://github.com/cycle/orm/pull/517Added a new behavior.
The ORM now will ignore relations and uninitialized Entity properties. In this case, unset($entity->relation) will not change the relation when saving, and it will hydrate it if the relation is loaded in the query.
To restore the old behavior where the ORM tries to fill all uninitialized relations if the entity is created not through the ORM (using new), and also treats unset as unlinking relations, pass an Options object into ORM constructor with the field $ignoreUninitializedRelations = false.
Full Changelog: https://github.com/cycle/orm/compare/v2.10.1...2.11.0-RC1
Fix a rare bug on selecting nested data by @gam6itko in https://github.com/cycle/orm/pull/512
Full Changelog: https://github.com/cycle/orm/compare/v2.10.0...v2.10.1
Changed behavior of EntityFactory by @roxblnfk in https://github.com/cycle/orm/pull/509
Explanation:
Let's imagine a situation:
- We loaded a
Userentity from the database.- We made some changes to the entity (changed some fields) but did not save it to the database.
- We requested several
Commententoitites from the database with eager loading of their authors (who areUserentities).- One of the authors of the loaded comments is the
Userfrom the first point.Before version 2.10:
- The
Userentity, whose fields we changed, resets to the state from the database.After version 2.10:
- The loaded data does not change.
- Only relations that were not loaded before can be hydrated.
If you want to work with new data from the database, you should clear the heap (fully or partially).
Full Changelog: https://github.com/cycle/orm/compare/v2.9.3...v2.10.0
Change behavior of EntityFactory by @roxblnfk in https://github.com/cycle/orm/pull/509 It doesn't overwrite entity fields now
Full Changelog: https://github.com/cycle/orm/compare/v2.9.3...v2.10.0-RC1
Removed "of object" from docBlock in "Cycle\ORM\RepositoryInterface" by @sicet7 in https://github.com/cycle/orm/pull/508
Full Changelog: https://github.com/cycle/orm/compare/v2.9.2...v2.9.3
Fix typo from 👿 to UNIX naming by @HenkPoley in https://github.com/cycle/orm/pull/505
Full Changelog: https://github.com/cycle/orm/compare/v2.9.1...v2.9.2
Fix PHP 8.4 deprecations by @roxblnfk in https://github.com/cycle/orm/pull/501
Full Changelog: https://github.com/cycle/orm/compare/v2.9.0...v2.9.1
Expose support for multiple with on the same relation by @roxblnfk and @gam6itko in #483, #482, #486
with on the same relation by @roxblnfk and @gam6itko in #483, #482, #486Full Changelog: https://github.com/cycle/orm/compare/v2.8.0...v2.9.0
Add method Repository::forUpdate() by @msmakouz in #465
Repository::forUpdate() by @msmakouz in #465fetchData() and fetchAll() methods by @lotyp and @roxblnfk in #478EntityProviderInterface::get() by @msmakouz in #474Full Changelog: https://github.com/cycle/orm/compare/v2.7.1...v2.8.0
Fix inserting order in regular cases by @roxblnfk and @gam6itko in https://github.com/cycle/orm/pull/381
Full Changelog: https://github.com/cycle/orm/compare/v2.7.0...v2.7.1
Add Generated Fields option into ORM Schema by @roxblnfk in https://github.com/cycle/orm/pull/462
Full Changelog: https://github.com/cycle/orm/compare/v2.6.1...v2.7.0
Fix compatibility with PHP 8.3 by @msmakouz in https://github.com/cycle/orm/pull/454
Full Changelog: https://github.com/cycle/orm/compare/v2.6.0...v2.6.1
Add support for loophp/collection v7. By @msmakouz in https://github.com/cycle/orm/pull/448
loophp/collection v7. By @msmakouz in https://github.com/cycle/orm/pull/448Full Changelog: https://github.com/cycle/orm/compare/v2.5.0...v2.6.0
loophp/collection v7 by @msmakouz (#448)Expose JSON methods in the Select query builder by @msmakouz in https://github.com/cycle/orm/pull/445
NullHeap by @roxblnfk in https://github.com/cycle/orm/pull/441Full Changelog: https://github.com/cycle/orm/compare/v2.4.0...v2.5.0
Add support uninitialized collections in entities by @roxblnfk
Full Changelog: https://github.com/cycle/orm/compare/v2.3.4...v2.4.0
Fix fields uncasting in the ManyToMany relation by @roxblnfk, thanks @gam6itko (#427, #428)
Full Changelog: https://github.com/cycle/orm/compare/v2.3.3...v2.3.4
Fix loading for Embedded entities when parent is null by @gam6itko and @roxblnfk (#422, #423)
Full Changelog: https://github.com/cycle/orm/compare/v2.3.2...v2.3.3
Fix proxy-mapper hydration mechanism: public relations in a non-proxy-entity are hydrated like private ones. There is a special logic related to Refer
ReferenceInterface hydrating. By @roxblnfk (#417)forUpdate in the Select phpdoc. By @msmakouz in (#413)Full Changelog: https://github.com/cycle/orm/compare/v2.3.1...v2.3.2
Fix typecasting in relations when JTI entities are loaded by @roxblnfk (#408, #409)
Full Changelog: https://github.com/cycle/orm/compare/v2.3.0...v2.3.1
Fix method naming: AbstractLoader::loadIerarchy() deprecated and renamed to ::loadHierarchy().
where() and orderBy() behavior in the JTI case. It possible to pass parent field name. By @roxblnfk (#405)Select::wherePK() is now more strict. Use entity field name instead of table columns.AbstractLoader::loadIerarchy() deprecated and renamed to ::loadHierarchy().\Cycle\ORM\Parser\Typecast is now not internal by @thenotsoft (#395)CaseTemplate by @gam6itko (#389)Full Changelog: https://github.com/cycle/orm/compare/v2.2.2...v2.3.0
-Fix compatibility with PHP 8.2 (AllowDynamicProperties) by @roxblnfk (#394) -Add tests with using for microseconds in a datetime fields by @BelaRyc a
-Fix compatibility with PHP 8.2 (AllowDynamicProperties) by @roxblnfk (#394) -Add tests with using for microseconds in a datetime fields by @BelaRyc and @msmakouz (#383)
Full Changelog: https://github.com/cycle/orm/compare/v2.2.1...v2.2.2
Fix EM::persistState() that inserted the same entity twice by @roxblnfk
EM::persistState() that inserted the same entity twice by @roxblnfk (#368)cascade mode in BelongsTo relation by @roxblnfk and @msmakouz (#347, #374)@readonly for Repository::$select by @roxblnfk (#369)Full Changelog: https://github.com/cycle/orm/compare/v2.2.0...v2.2.1
Add supporting for `loophp/collection` by @drupol
loophp/collection by @drupol (#344)Cycle\ORM\Parser\Typecast by @roxblnfk (#352)template annotations in Cycle\ORM\Select\Repository and Cycle\ORM\Select classes by @roxblnfk (#351)Cycle\ORM\Transaction\UnitOfWork and Cycle\ORM\Transaction\Runner are now not internal by @roxblnfk (#353)Full Changelog: https://github.com/cycle/orm/compare/v2.1.1...v2.2.0
Nothing published for this version
Remove $config property overriding in the RelationConfig by @msmakouz
$config property overriding in the RelationConfig by @msmakouz (#343)Full Changelog: https://github.com/cycle/orm/compare/v2.1.0...v2.1.1
Remove final from the Select class by @msmakouz
final from the Select class by @msmakouz (#327)@template annotations to RepositoryInterface by @roxblnfkFull Changelog: https://github.com/cycle/orm/compare/v2.0.2...v2.1.0
Fix a Tuple updating in the Pool by @roxblnfk
Full Changelog: https://github.com/cycle/orm/compare/v2.0.1...v2.0.2
Fix protected relation fields hydration on eager loading by @roxblnfk in https://github.com/cycle/orm/pull/314
Full Changelog: https://github.com/cycle/orm/compare/v2.0.0...v2.0.1
'Joined Table Inheritance' and 'Single Table Inheritance'
Cycle\Orm\Mapper\Mapper)Cycle\ORM\Transactionminor fix for php8.1 compatibility by @wezztt in https://github.com/cycle/orm/pull/514
Full Changelog: https://github.com/cycle/orm/compare/v1.8.1...v1.8.2
Add the STI discriminator autoadding in the Schema by @gam6itko
origin in the HasMany::queue() when it's instance of Collection by @roxblnfk (#277)Full Changelog: https://github.com/cycle/orm/compare/v1.8.0...v1.8.1
Added ORM::with. Other ORM::with* methods marked as deprecated
ORM::with. Other ORM::with* methods marked as deprecated (#257)ConstrainInterface and ScopeInterface (#271)Fixed Node::getChanges() when a key in $current argument is undefined
Node::getChanges() when a key in $current argument is undefined (#238)Update the Node data comparison mechanism
Prevent repeating entity hydration in the 'has many' relation
Added Scope classes and deprecations for Constrain classes
Scope classes and deprecations for Constrain classes (#209)Hotfix: missing type casting to string for primary key
- Hotfix: PK changes not tracked (#179) - Better heap sync
Fix inserting empty entities by @roxblnfk
Added support of Doctrine/Annotations v2 by @roxblnfk
One column per quarter.