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.