README

Reusable PHP traits for Doctrine entities, designed for Symfony projects.

This library provides a collection of common traits to reduce boilerplate code when working with Doctrine ORM.

📦 Installation

Install via Composer:

composer require eelan/doctrine-traits

⚠️ If the package is not yet published on Packagist, you can include the GitHub repository manually in your composer.json.

🧱 Available Traits

`Eelan\DoctrineTraits\Common`

IdTrait – Auto-increment integer ID
TimestampTrait – createdAt, updatedAt (with lifecycle callbacks)
SoftDeleteTrait – deletedAt, with delete() and restore() methods

`Eelan\DoctrineTraits\Contact`

PhoneTrait – phone
EmailTrait – email

`Eelan\DoctrineTraits\Personal`

NameTrait – firstName, lastName
GenderTrait – gender (based on enum Gender: MALE, FEMALE, OTHER, UNKNOWN)
BirthTrait – birthDate, birthPlace

`Eelan\DoctrineTraits\Location`

AddressTrait – streetName, streetNumber, postalCode, city
ExtendedAddressTrait – extends AddressTrait and adds region, country
GpsCoordinateTrait – latitude, longitude, and grouped coordinate helpers

🛠 Usage

In your Doctrine entity:

use Eelan\DoctrineTraits\Common\IdTrait;
use Eelan\DoctrineTraits\Location\AddressTrait;
use Eelan\DoctrineTraits\Contact\EmailTrait;

class Person
{
    use IdTrait;
    use AddressTrait;
    use EmailTrait;

    // your custom fields...
}

All fields are mapped using PHP 8+ attributes (#[ORM\Column(...)]).

🧪 Example Entity

See examples/Person.php for a complete example using all traits.

📄 License

This project is licensed under the MIT License.
See the LICENSE file for details.

🙌 Contributions

Contributions are welcome!
Feel free to open an issue or submit a pull request with new traits or improvements.

eelan / doctrine-traits

Maintainers

Details