PHPackages                             bouleluciole/laravel-eloquent-traits - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. bouleluciole/laravel-eloquent-traits

ActiveLibrary[Database & ORM](/categories/database)

bouleluciole/laravel-eloquent-traits
====================================

Reusable Eloquent traits for UUID, ULID, Slugs and more

0.1(4mo ago)044MITPHPPHP ^8.2

Since Jan 5Pushed 4mo agoCompare

[ Source](https://github.com/Samy-Green/laravel-eloquent-traits)[ Packagist](https://packagist.org/packages/bouleluciole/laravel-eloquent-traits)[ RSS](/packages/bouleluciole-laravel-eloquent-traits/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (7)Versions (2)Used By (0)

Laravel Eloquent Traits
=======================

[](#laravel-eloquent-traits)

Une collection de traits Eloquent robustes et configurables pour automatiser les tâches répétitives de vos modèles Laravel : gestion des médias (compression, miniatures, nettoyage), slugs uniques et identifiants UUID.

🚀 Installation
--------------

[](#-installation)

Installez le package via Composer :

```
composer require bouleluciole/laravel-eloquent-traits
```

Le package nécessite PHP 8.2+ et Laravel 11.0+. Les fonctionnalités d'image dépendent de `intervention/image` (v3).

🛠 Fonctionnalités
-----------------

[](#-fonctionnalités)

### 1. Compression d'Images (`CompressImage`)

[](#1-compression-dimages-compressimage)

Compresse intelligemment vos images au format WebP pour économiser de l'espace disque tout en préservant la qualité.

```
use EloquentTraits\Traits\CompressImage;

class Post extends Model
{
    use CompressImage;

    // Champs à compresser (clé => disque ou simplement valeur si disque par défaut)
    protected $compressibleImageFields = [
        'photo_path' => 'public',
        'avatar'
    ];

    // Taille maximale autorisée en Ko (défaut: 500)
    protected $imageCompressionMaxSize = 800;
}
```

### 2. Génération de Miniatures (`GeneratesThumbnail`)

[](#2-génération-de-miniatures-generatesthumbnail)

Génère automatiquement des thumbnails WebP lors de la sauvegarde. Supporte les fichiers locaux et les URLs distantes.

```
use EloquentTraits\Traits\GeneratesThumbnail;

class Photo extends Model
{
    use GeneratesThumbnail;

    protected $thumbnailConfig = [
        [
            'source' => 'photo_path',
            'target' => 'thumbnail',
            'width'  => 300,
            'height' => 200,
            'prefix' => 'thumbnails/posts/'
        ]
    ];
}
```

### 3. Nettoyage Automatique (`DeletesFilesOnModel`)

[](#3-nettoyage-automatique-deletesfilesonmodel)

Supprime physiquement les fichiers du stockage lorsque le modèle est supprimé ou lorsqu'un champ de fichier est mis à jour. Gère nativement le `SoftDeletes`.

```
use EloquentTraits\Traits\DeletesFilesOnModel;

class Document extends Model
{
    use DeletesFilesOnModel;

    // Champs contenant des chemins de fichiers
    protected $fileFields = ['file_path', 'attachment'];

    // Disques à scanner pour la suppression
    protected $fileDisks = ['public', 's3'];
}
```

### 4. Slugs Uniques (`GeneratesSlug`)

[](#4-slugs-uniques-generatesslug)

Génère des slugs URL-friendly uniques. Si un slug existe déjà, il ajoute automatiquement un suffixe incrémental (ex: `titre`, `titre-2`, etc.).

```
use EloquentTraits\Traits\GeneratesSlug;

class Article extends Model
{
    use GeneratesSlug;

    protected string $slugSourceField = 'title'; // Défaut: 'name'
    protected string $slugColumn = 'slug';       // Défaut: 'slug'
}
```

### 5. Identifiants UUID (`UseUuid`)

[](#5-identifiants-uuid-useuuid)

Remplace les IDs incrémentaux par des UUIDs version 4 générés automatiquement.

```
use EloquentTraits\Traits\UseUuid;

class Order extends Model
{
    use UseUuid;

    // Désactive l'auto-incrémentation pour ce modèle
    public $incrementing = false;
    protected $keyType = 'string';
}
```

🧪 Tests
-------

[](#-tests)

Le package est testé avec Pest PHP et utilise Orchestra Testbench pour simuler un environnement Laravel complet.

```
composer test
```

📖 Détails Techniques
--------------------

[](#-détails-techniques)

### Cycle de vie (Events)

[](#cycle-de-vie-events)

Les traits utilisent les hooks standards d'Eloquent (`creating`, `saving`, `saved`, `deleting`, `updating`) pour agir au bon moment sans intervention manuelle.

### Gestion du stockage

[](#gestion-du-stockage)

Tous les traits de fichiers respectent l'abstraction du système de fichiers de Laravel (`Storage`). Ils sont compatibles avec les disques `local`, `public`, `s3`, etc.

📄 Licence
---------

[](#-licence)

Ce projet est sous licence MIT. Pour plus d'informations, veuillez consulter le fichier LICENSE.

🤝 Contribution
--------------

[](#-contribution)

Les contributions sont les bienvenues !

1. Forkez le projet.
2. Créez votre branche de fonctionnalité (`git checkout -b feature/AmazingFeature`).
3. Commitez vos changements (`git commit -m 'Add some AmazingFeature'`).
4. Pushez sur la branche (`git push origin feature/AmazingFeature`).
5. Ouvrez une Pull Request.

---

Développé avec ❤️ par **Boule Luciole** -

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance77

Regular maintenance activity

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

127d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b050733774fb93d80fea45ba3d5c63a31f4540c399836c6e7984c9b538b60426?d=identicon)[Samy-Green](/maintainers/Samy-Green)

---

Top Contributors

[![Samy-Green](https://avatars.githubusercontent.com/u/85443053?v=4)](https://github.com/Samy-Green "Samy-Green (3 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/bouleluciole-laravel-eloquent-traits/health.svg)

```
[![Health](https://phpackages.com/badges/bouleluciole-laravel-eloquent-traits/health.svg)](https://phpackages.com/packages/bouleluciole-laravel-eloquent-traits)
```

###  Alternatives

[cybercog/laravel-love

Make Laravel Eloquent models reactable with any type of emotions in a minutes!

1.2k302.7k1](/packages/cybercog-laravel-love)[cviebrock/eloquent-taggable

Easy ability to tag your Eloquent models in Laravel.

567694.8k3](/packages/cviebrock-eloquent-taggable)[clickbar/laravel-magellan

This package provides functionality for working with the postgis extension in Laravel.

423715.4k1](/packages/clickbar-laravel-magellan)[genealabs/laravel-pivot-events

This package introduces new eloquent events for sync(), attach(), detach() or updateExistingPivot() methods on BelongsToMany relation.

1404.9M8](/packages/genealabs-laravel-pivot-events)[reedware/laravel-relation-joins

Adds the ability to join on a relationship by name.

2121.2M13](/packages/reedware-laravel-relation-joins)[aglipanci/laravel-eloquent-case

Adds CASE statement support to Laravel Query Builder.

115157.2k](/packages/aglipanci-laravel-eloquent-case)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)