Entity Behaviours

Dave Redfern

Published: 09 Oct 22:35 in Deprecated

Entity Behaviours

This library has been deprecated and the repository archived. The functionality has been moved to the somnambulist/domain package.

Provides some useful interfaces and traits that can be used with entities. The traits implement on basic methods, and still require e.g. publish/unpublish to be implemented.

Requirements

  • PHP 7+

Installation

Install using composer, or checkout / pull the files from github.com.

  • composer require somnambulist/entity-behaviours

Behaviours

Unlike the somnambulist/laravel-doctrine-behaviours package, these behaviours are intended to be used in a much more controlled and DDD based system. As such they do not implement setters and in some cases even the methods defined in the interfaces as these are core domain methods that should raise events within your system.

  1. Activatable

    Adds activate()/deactivate() methods to an entity controlling if it is active or not. The entity should implement activate/deactivate methods so that Events can be raised.

  2. GloballyTrackable

    A collection of other interfaces: Identifiable, Nameable, Timestampable, UniversallyIdentifiable.

  3. Identifiable

    Adds an id() method that returns the primary identifier (int, string, object)

  4. IdentifiableWithTimestamps

    A combination of Identifiable and Timestampable

  5. Nameable

    Adds a name() method that returns the entity name component.

  6. NumericallySortable

    Adds an ordinal() and update method for adding a numerical sorting index to an entity.

  7. Publishable

    Adds publish()/unpublish() for controlling if an Entity is "published". Uses the DateTime value object. publish/unpublish are not implemented as they should raise events when used.

  8. Stringable

    Adds __toString() and a toString() method that will use try the following methods:

    • displayAs()
    • title()
    • name()

    If none are present an empty string is returned.

  9. Timestampable

    Adds createdAt()/updatedAt() methods. Not setters are not defined as the entity should update the updatedAt when it is changed through update calls and not rely on database behaviour.

  10. Trackable

    A collection of other interfaces: Identifiable, Nameable, Timestampable

  11. UniversallyIdentifiable

    Adds a uuid() method that returns a Uuid value object.

  12. Versionable

    Adds a version() and incrementVersion() methods for defining the current entity version. incrementVersion should be hooked in appropriate update methods when the entity is modified.

Utilities

  • EntityAccessor

    Helper class for accessing property methods/properties. Intended to be used in unit tests only.

Return to article