doctrine-extensions/DoctrineExtensions
DoctrineExtensions
DoctrineExtensions is a collection of reusable behavioral extensions for Doctrine ORM designed to automate common entity tasks. It provides a system for tracking historical changes to database entities, implementing soft deletion workflows, managing nested set tree structures for hierarchical data, and storing translated field values based on language locales.
The project distinguishes itself by providing specialized tools for entity auditing, which logs modified values and timestamps, and a translation framework for multilingual content management. It also includes a tree manager to organize entities into parent and child relationships and a mechanism to mark records as deleted without physically removing them from the database.
Additional capabilities cover automated metadata tracking for timestamps and user ownership, the generation of search engine friendly URL slugs, and the management of entity sequences. The toolkit also handles the processing of file uploads within data fields.
Features
- ORM Extensions - Provides a suite of reusable behavioral extensions to enhance the core functionality of the Doctrine ORM.
- Multilingual Content Management - Manages the storage and retrieval of translated entity fields to support multilingual content.
- Automatic Record Timestamping - Automates the assignment of creation and modification timestamps whenever entities are persisted.
- Database Record Auditing - Provides detailed auditing of database records by logging the specific property values that were changed.
- Translation Entities - Implements a data pattern where base entities are linked to separate translation entities for global audiences.
- Nested Set Modeling - Implements the nested set pattern using left and right integer boundaries to manage hierarchical tree structures.
- Soft Deletion - Provides a mechanism to mark records as deleted using a boolean flag instead of physical removal.
- Tree Entity Management - Provides specialized methods for manipulating and managing entities within hierarchical tree structures.
- Change Tracking - Tracks record history and versioning to monitor exactly what changed and when.
- Entity Audit Logs - Provides a system to record snapshots of entity states into a separate log table for a full historical audit trail.
- Hierarchical Data Structures - Organizes objects into tree structures to efficiently retrieve parent and child relationships.
- Field-Level Translation Storage - Implements a database storage pattern that maps entity fields to separate translation tables based on language locales.
- Eloquent Model Event Listeners - Intercepts entity lifecycle events to automatically update metadata like timestamps and ownership before persistence.
- Entity Ownership Tracking - Automatically updates entity fields with a user reference whenever a record is created or modified.
- Trait-Based Capability Injection - Uses PHP traits to inject common behavioral logic like timestamping and sluggability across different entity classes.
- Slug Generators - Generates search-engine-friendly URL slugs from entity data to be used as permanent web addresses.
- URL Slug Generators - Generates search engine friendly URL slugs from data to improve indexing and navigation.
- Database Interaction - Adds behavioral extensions to the ORM.
