Download the PHP package andydefer/laravel-utils without Composer
On this page you can find all versions of the php package andydefer/laravel-utils. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download andydefer/laravel-utils
More information about andydefer/laravel-utils
Files in andydefer/laravel-utils
Package laravel-utils
Short Description Utility package for Laravel including Transformable proxies and helpers
License MIT
Informations about the package laravel-utils
Laravel Utils
Table des matières
- Description
- Installation
- Prérequis
- Fonctionnalités
- 4.1 TransformableProxy
- 4.2 AttributeProxy
- 4.3 GitPushDirective
- 4.4 GitDiffDirective
- 4.5 GitTagDirective
- Configuration
- 5.1 Publication de la configuration
- 5.2 Configuration des dépôts Git
- 5.3 Configuration des extensions
- Documentation
- Tests
- Contribuer
- Licence
- Auteur
- Dépendances
Description
Package d'utilitaires pour Laravel offrant des proxies pour l'hydratation automatique d'objets Transformable (Value Objects, Records, DTOs) depuis des sources variées (tableaux, JSON, colonnes de base de données) ainsi que des directives CLI pour automatiser les workflows Git (push, génération de diff pour revue IA, et versionnement sémantique).
Installation
Publication de la configuration (optionnelle)
Pour personnaliser les paramètres du package (dépôts Git, extensions, etc.) :
Cette commande publiera le fichier config/utils.php dans votre application.
Note : La publication de la configuration n'est pas obligatoire. Si vous ne publiez pas le fichier, le package utilisera les valeurs par défaut.
Prérequis
- PHP 8.1 ou supérieur
- Laravel 10.x, 11.x, 12.x, 13.x, 14.x ou 15.x
andydefer/domain-structures^1.0- Git (pour les directives CLI)
- VS Code (optionnel, pour l'ouverture automatique des fichiers)
Fonctionnalités
TransformableProxy
Proxy statique pour créer des objets Transformable depuis diverses sources :
AttributeProxy
Proxy pour créer des attributs Eloquent qui hydratent automatiquement des objets Transformable depuis les colonnes de base de données.
Méthodes disponibles
| Méthode | Description |
|---|---|
required() |
Attribut requis (non-nullable) |
nullable() |
Attribut nullable |
make() |
⚠️ Dépréciée - Utiliser required() ou nullable() |
Exemple d'utilisation
Gestion automatique du Set
Lorsque vous spécifiez une colonne (column), AttributeProxy gère automatiquement la persistance :
GitPushDirective
Directive CLI pour pousser du code vers des dépôts Git distants configurés avec mode interactif et options avancées.
Paramètres :
| Paramètre | Description |
|---|---|
{sources*} |
Alias des dépôts configurés (vide = push vers tous) |
{folders*} |
Dossiers à ajouter (vide = tous les fichiers) |
--no-tests |
Ignorer l'exécution des tests |
--force-with-lease |
Utiliser --force-with-lease au lieu de --force |
--force |
Forcer le push même si les tests échouent |
--no-interactive |
Désactiver le mode interactif |
--dry-run |
Simuler l'opération sans rien exécuter |
GitDiffDirective
Directive CLI pour générer un diff Git formaté pour la revue de code par IA.
Paramètres :
| Paramètre | Description |
|---|---|
{paths*} |
Chemins à inclure (ex: [src, tests]) |
{extensions*} |
Extensions à filtrer (ex: [.php, .js]) |
--frontend |
Utiliser les extensions frontend de la config |
--backend |
Utiliser les extensions backend de la config |
--recipes |
Sélectionner les recettes d'extensions interactivement |
--with-summary |
Créer un résumé de travail après le diff |
--no-interactive |
Désactiver le mode interactif |
--dry-run |
Simuler l'opération sans écrire de fichier |
Recettes d'extensions par défaut :
| Recette | Extensions |
|---|---|
frontend |
js, ts, tsx, jsx, vue, css, scss, sass, less, html, xml |
backend |
php, py, rb, go, rs, java, c, cpp, h, hpp |
GitTagDirective
Directive CLI pour créer des tags de version Git avec versioning sémantique (SemVer).
Paramètres :
| Paramètre | Description |
|---|---|
{type} |
Type de tag : patch, minor, major (défaut: patch) |
--no-push |
Ne pas pousser le tag vers le dépôt distant |
--republish |
Re-publier le dernier tag (force push) |
--dry-run |
Simuler l'opération sans rien exécuter |
{message} |
Message personnalisé pour le tag |
Fonctionnalités :
- Versionnement sémantique automatique (SemVer)
- Message personnalisé pour les tags
- Simulation (dry-run) sans effectuer de modifications
- Re-publication forcée des tags existants
- Gestion des erreurs et des cas limites
- Interface utilisateur enrichie avec couleurs et icônes
Exemple de sortie :
Configuration
Publication de la configuration
Pour personnaliser les paramètres du package, publiez d'abord le fichier de configuration :
Cette commande crée le fichier config/utils.php dans votre application.
Configuration des dépôts Git
Configuration des extensions
Configuration du déploiement
Documentation
- TransformableProxy - Référence Technique
- AttributeProxy - Référence Technique
- GitPushDirective - Référence Technique
- GitDiffDirective - Référence Technique
- GitTagDirective - Référence Technique
Tests
Contribuer
- Forker le projet
- Créer une branche (
git checkout -b feature/ma-fonctionnalite) - Commiter les changements (
git commit -m 'Ajout de ma fonctionnalité') - Pusher (
git push origin feature/ma-fonctionnalite) - Ouvrir une Pull Request
Licence
MIT © Andy Defer
Auteur
- Andy Defer - GitHub
Dépendances
andydefer/domain-structures- Interfaces et classes de base pour les objets transformablesilluminate/database- Pour les attributs Eloquentsymfony/process- Pour l'exécution des commandes Gitandydefer/laravel-directive- Pour l'infrastructure des directives CLIandydefer/console-writer- Pour l'interface utilisateur en CLI
All versions of laravel-utils with dependencies
laravel/framework Version ^12.0|^13.0|^14.0|^15.0
andydefer/laravel-task Version ^4.15.4