GitPedia

Orm

PHP DataMapper, ORM

From cycle·Updated June 21, 2026·View on GitHub·

Cycle is PHP DataMapper, ORM and Data Modelling engine designed to safely work in classic and daemonized PHP applications (like [RoadRunner](https://github.com/spiral/roadrunner)). The ORM provides flexible configuration options to model datasets, powerful query builder and supports dynamic mapping schema. The engine can work with plain PHP objects, support annotation declarations, and proxies via extensions. The project is written primarily in PHP, distributed under the MIT License license, first published in 2018. It has gained significant community traction with 1,331 stars and 84 forks on GitHub. Key topics include: cycle, datamapper, hacktoberfest, mapper, orm.

Latest release: v2.18.0
June 15, 2026View Changelog →

Cycle ORM

Latest Stable Version
Scrutinizer Code Quality
Codecov
Discord
Meta Storm Plugin

<img src="https://cycle-orm.dev/cycle.png" height="135px" alt="Cycle ORM" align="left"/>

Cycle is PHP DataMapper, ORM and Data Modelling engine designed to safely work in classic and daemonized PHP
applications (like RoadRunner). The ORM provides flexible configuration options
to model datasets, powerful query builder and supports dynamic mapping schema. The engine can work with plain PHP
objects, support annotation declarations, and proxies via extensions.

<p align="center"> <a href="https://cycle-orm.dev/docs"><b>Website and Documentation</b></a> | <a href="https://github.com/cycle/docs/issues/3">Comparison with Eloquent and Doctrine</a> </p>

Features

  • ORM with has-one, has-many, many-through-many and polymorphic relations
  • Plain Old PHP objects, AR, Custom objects
    or same entity type for multiple repositories
  • eager and lazy loading, query builder with multiple fetch strategies
  • embedded entities, lazy/eager loaded embedded partials
  • runtime configuration with/without code-generation
  • column-to-field mapping, single table inheritance, value objects support
  • hackable: persist strategies, mappers, relations, transactions
  • works with directed graphs and cyclic graphs using command chains
  • designed to work in long-running applications: immutable service core, disposable UoW
  • supports MySQL, MariaDB, PostgresSQL, SQLServer, SQLite
  • schema scaffolding, introspection, migrations and debugging
  • supports global query scopes, UUIDs as PK, soft deletes, auto timestamps and macros
  • custom column types, FKs to non-primary columns
  • use with or without annotations, proxy classes, and auto-migrations
  • compatible with Doctrine Collections, Illuminate Collections and custom collections
  • compatible with Doctrine Annotations, PHP8 attributes

Extensions

ComponentCurrent Status
cycle/active-recordLicense PHP Stable Release Total Downloads
cycle/schema-builderLicense PHP Stable Release Total Downloads
cycle/schema-rendererLicense PHP Stable Release Total Downloads
cycle/schema-providerLicense PHP Stable Release Total Downloads
cycle/annotatedLicense PHP Stable Release Total Downloads
cycle/migrationsLicense PHP Stable Release Total Downloads
cycle/entity-behaviorLicense PHP Stable Release Total Downloads
cycle/entity-behavior-uuidLicense PHP Stable Release Total Downloads
cycle/databaseLicense PHP Stable Release Total Downloads
cycle/schema-migrations-generatorLicense PHP Stable Release Total Downloads
cycle/orm-promise-mapperLicense PHP Stable Release Total Downloads

Example:

php
// load all active users and pre-load their paid orders sorted from newest to olders // the pre-load will be complete using LEFT JOIN $users = $orm->getRepository(User::class) ->select() ->where('active', true) ->load('orders', [ 'method' => Select::SINGLE_QUERY, 'load' => function($q) { $q->where('paid', true)->orderBy('timeCreated', 'DESC'); } ]) ->fetchAll(); $em = new EntityManager($orm); foreach($users as $user) { $em->persist($user); } $em->run();

License:

Cycle ORM is open-sourced software licensed under the MIT license.
Maintained by Spiral Scout.

Contributors

Showing top 12 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from cycle/orm via the GitHub API.Last fetched: 6/23/2026