Annotated Laravel Package

4.6.1 (2026-09-29)

Dependencies

• advertise cycle-orm-attributes skill via llm/skills (e84262d)

What's Changed

• Add RefersToMorphed relation attribute by @roxblnfk in https://github.com/cycle/annotated/pull/123

Full Changelog: https://github.com/cycle/annotated/compare/v4.5.0...v4.6.0

What's Changed

• Allow BackedEnum as default value in Column definition by @roxblnfk in https://github.com/cycle/annotated/pull/122

Full Changelog: https://github.com/cycle/annotated/compare/v4.4.1...v4.5.0

What's Changed

• Add test for custom Column attributes (charset, collation) by @roxblnfk in https://github.com/cycle/annotated/pull/121
• Fix for duplicating parent relation columns to child tables in JTI by @peldax in https://github.com/cycle/annotated/pull/100

New Contributors

• @peldax made their first contribution in https://github.com/cycle/annotated/pull/100

Full Changelog: https://github.com/cycle/annotated/compare/v4.4.0...v4.4.1

What's Changed

• Support PHP Enums in Enum Column values by @puzzledpolymath in https://github.com/cycle/annotated/pull/119

Full Changelog: https://github.com/cycle/annotated/compare/v4.3.1...v4.4.0

What's Changed

• Add hints for ULID and snowflake column types by @puzzledpolymath in https://github.com/cycle/annotated/pull/117

New Contributors

• @puzzledpolymath made their first contribution in https://github.com/cycle/annotated/pull/117

Full Changelog: https://github.com/cycle/annotated/compare/v4.3.0...v4.3.1

What's Changed

• Added the ability to specify typecasts in the Embeddable attribute by @KorDum in https://github.com/cycle/annotated/pull/116

New Contributors

• @KorDum made their first contribution in https://github.com/cycle/annotated/pull/116

Full Changelog: https://github.com/cycle/annotated/compare/v4.2.5...v4.3.0

What's Changed

• Metastorm: add fields autocompletion for ORM::make by @roxblnfk in https://github.com/cycle/annotated/pull/114

Full Changelog: https://github.com/cycle/annotated/compare/v4.2.4...v4.2.5

What's Changed

• Metastorm: cover inner and outer keys in relations by @roxblnfk in https://github.com/cycle/annotated/pull/111

Full Changelog: https://github.com/cycle/annotated/compare/v4.2.3...v4.2.4

What's Changed

• update meta-storm syntax by @xepozz in https://github.com/cycle/annotated/pull/106

New Contributors

• @xepozz made their first contribution in https://github.com/cycle/annotated/pull/106

Full Changelog: https://github.com/cycle/annotated/compare/v4.2.2...v4.2.3

What's Changed

• Add MetaStorm metadata by @roxblnfk in https://github.com/cycle/annotated/pull/105

Full Changelog: https://github.com/cycle/annotated/compare/v4.2.1...v4.2.2

What's Changed

• Maintenance by @roxblnfk in https://github.com/cycle/annotated/pull/104
  • Resolve PHP 8.4 deprecations
  • Apply Spiral Code Style

Full Changelog: https://github.com/cycle/annotated/compare/v4.2.0...v4.2.1

What's Changed

• Support more types as value of SingleTable attribute by @vjik in https://github.com/cycle/annotated/pull/103

New Contributors

• @vjik made their first contribution in https://github.com/cycle/annotated/pull/103

Full Changelog: https://github.com/cycle/annotated/compare/v4.1.0...v4.2.0

What's Changed

• Add support for generated fields by @msmakouz in https://github.com/cycle/annotated/pull/95
• Add additional tests to cover unsigned and zerofill attributes by @msmakouz in https://github.com/cycle/annotated/pull/94

Full Changelog: https://github.com/cycle/annotated/compare/v4.0.0...v4.1.0

What's Changed

• Support for generated fields by @msmakouz in https://github.com/cycle/annotated/pull/96

Full Changelog: https://github.com/cycle/annotated/compare/v3.4.0...v3.5.0

What's Changed

• Logic for entity detection has been rewritten using Tokenizer Listeners by @msmakouz in https://github.com/cycle/annotated/pull/60
• doctrine/annotations has been moved to the require-dev section by @msmakouz in https://github.com/cycle/annotated/pull/73
• The minimum PHP version has been raised to 8.1 by @msmakouz in https://github.com/cycle/annotated/pull/81
• Removed deprecated code by @msmakouz in https://github.com/cycle/annotated/pull/83
• AttributeReader was set as the default reader by @msmakouz in https://github.com/cycle/annotated/pull/93

Full Changelog: https://github.com/cycle/annotated/compare/v3.4.0...v4.0.0

What's Changed

• Removing unused import by @msmakouz in https://github.com/cycle/annotated/pull/90
• Expose a Foreign Key definition via the new ForeignKey attribute by @msmakouz in https://github.com/cycle/annotated/pull/91

Foreign Key declaration via attributes

Now, you can easily define foreign keys in your entity classes using attributes, without needing any relation definitions.

How It Works:

1. Define Entities using the #[Entity] attribute. For example, a User entity can be created with an ID as the primary key.

   use Cycle\Annotated\Annotation\Entity;
   use Cycle\Annotated\Annotation\Column;
   
   #[Entity]
   class User
   {
       #[Column(type: 'primary')]
       public int $id;
   }
   

2. Set up Foreign Keys in two ways:

• Directly on Properties: You can annotate a property in your class to indicate it's a foreign key related to another entity.

  use Cycle\Annotated\Annotation\Entity;
  use Cycle\Annotated\Annotation\ForeignKey;
  
  #[Entity]
  class Post
  {
      // ...
      #[Column(type: 'integer')]
      #[ForeignKey(target: User::class, action: 'CASCADE')]
      private int $userId;
  }
  

• Or, on the Class Itself: Alternatively, you can place the foreign key annotation at the class level, specifying details like which property in your class is the foreign key (innerKey), and which property in the related class it corresponds to (outerKey).

  use Cycle\Annotated\Annotation\Entity;
  use Cycle\Annotated\Annotation\ForeignKey;
  
  #[Entity]
  #[ForeignKey(target: User::class, innerKey: 'userId', outerKey: 'id', action: 'CASCADE')]
  class Post
  {
      // ...
      #[Column(type: 'integer')]
      private int $userId;
  }
  

Full Changelog: https://github.com/cycle/annotated/compare/v3.3.1...v3.4.0

What's Changed

• Fix table name searching when using table inheritance. It no longer depends on the order of class scanning using the Tokenizer by @msmakouz in https://github.com/cycle/annotated/pull/88

Full Changelog: https://github.com/cycle/annotated/compare/v3.3.0...v3.3.1

What's Changed

• Describe new column types in #[Column] expected values by @msmakouz in https://github.com/cycle/annotated/pull/70
• Add ability to define any column attributes by @roxblnfk and @gam6itko in https://github.com/cycle/annotated/pull/53
• Add ability to parse parent class attributes in the MergeColumns generator by @msmakouz in https://github.com/cycle/annotated/pull/72
• Add readonlySchema to the Column annotation by @msmakouz in https://github.com/cycle/annotated/pull/75

Full Changelog: https://github.com/cycle/annotated/compare/v3.2.1...v3.3.0

What's Changed

• Fix that the JTI parent has fields from children by @msmakouz in #65 thx @kastahov for tests in #64
• Add smallInteger type hint to the Column attribute by @gam6itko in #52
• Extend supporting for doctrine/annotations to version 2.0 by @msmakouz in #66
• Fix bug #54 when children were not added on using attributes without dockblock by @makedo in #55

New Contributors

• @kastahov made their first contribution in https://github.com/cycle/annotated/pull/64
• @makedo made their first contribution in https://github.com/cycle/annotated/pull/55

Full Changelog: https://github.com/cycle/annotated/compare/v3.2.0...v3.2.1

What's Changed

• Add supporting for PHP 8.1 Enum by @roxblnfk in https://github.com/cycle/annotated/pull/56
• Allow Spiral Framework 3.x by @msmakouz in https://github.com/cycle/annotated/pull/57

Full Changelog: https://github.com/cycle/annotated/compare/v3.1.0...v3.2.0

What's Changed

• Add test cases related to different relation field definitions by @roxblnfk (#44)
• Add prefix parameter to Embedded by @msmakouz (#46)
• Add Foreign Keys for JTI by @msmakouz in (#43)
• Fix comment to the Column field 'typecast' by @roquie (#49)
• Fix error related with morphKey default value by @roxblnfk in (#50)

New Contributors

• @roquie made their first contribution in https://github.com/cycle/annotated/pull/49

Full Changelog: https://github.com/cycle/annotated/compare/v3.0.0...v3.1.0

What's Changed

• Introduce PrimaryKey class level annotation for composite pkeys by @rauanmayemir in https://github.com/cycle/annotated/pull/19
• Deprecate though, add through annotation stubs by @rauanmayemir in https://github.com/cycle/annotated/pull/20
• Rename constrain to scope;
• Add composite keys supporting by @roxblnfk in https://github.com/cycle/annotated/pull/26
• Replaced Spiral\Database with Cycle\Database by @butschster in https://github.com/cycle/annotated/pull/22
• Support custom collection and entity typecast handlers by @butschster in https://github.com/cycle/annotated/pull/29
• Add supporting for SchemaModifiers annotations in Entities by @roxblnfk in https://github.com/cycle/annotated/pull/30
• Adds STI/JTI support by @butschster in https://github.com/cycle/annotated/pull/31
• Replaces Annotation\Attributes with Annotation\NamedArgumentConstructor for all Annotation classes by @butschster in https://github.com/cycle/annotated/pull/34
• Rearranged tests structure by @butschster in https://github.com/cycle/annotated/pull/35

New Contributors

• @butschster made their first contribution in https://github.com/cycle/annotated/pull/22
• @msmakouz made their first contribution in https://github.com/cycle/annotated/pull/28

Full Changelog: https://github.com/cycle/annotated/compare/v2.3.1...v3.0.0

• Fix STI configuration via attributes (#37)

• Added the scope parameter in the Entity attribute (#27)

• Fix property parameter of the Column attribute/annotation (#18)

• Added new annotations syntax and PHP attributes support (#17)

• Add supporting of orderBy option in relations (#15)

• Bump spiral dependecy to 2.7

Upgrade composer PHP version

• updated to recent Doctrine/Infector API continued

• updated to recent Doctrine/Infector API