Download the PHP package axn/laravel-models-organizer without Composer
On this page you can find all versions of the php package axn/laravel-models-organizer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download axn/laravel-models-organizer
More information about axn/laravel-models-organizer
Files in axn/laravel-models-organizer
Package laravel-models-organizer
Short Description Organize Laravel models concerns (relations, scopes, attributes) in dedicated traits.
License MIT
Homepage https://github.com/AXN-Informatique/laravel-models-organizer
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-models-organizer
Laravel Models Organizer
Package Laravel permettant d’organiser automatiquement le code des modèles Eloquent en déplaçant les relations, scopes et attributes dans des traits dédiés.
Installation
Utilisation
Analyser tous les modèles :
Analyser un modèle précis :
Simuler les modifications sans écrire les fichiers :
Objectif
La commande déplace automatiquement :
- les relations Eloquent vers
Relations.php - les scopes vers
Scopes.php - les accessors / mutators / attributes vers
Attributes.php
Exemple :
Pour un modèle dans un sous-namespace :
Règles de détection
Relations
Une méthode est considérée comme relation si :
- son type de retour commence par
Illuminate\Database\Eloquent\Relations\ - ou si elle retourne explicitement une relation Eloquent via
$this->belongsTo(...),$this->hasMany(...), etc.
Scopes
Une méthode est considérée comme scope si :
- son nom commence par
scope - ou si elle possède l’attribut
#[Scope]
Attributes
Une méthode est considérée comme attribute si :
- son nom respecte
get*Attribute - son nom respecte
set*Attribute - ou si son type de retour est
Illuminate\Database\Eloquent\Casts\Attribute
Traits analysés
La commande analyse :
- les méthodes directement déclarées dans le modèle
- les méthodes déclarées dans les traits utilisés par le modèle
- les méthodes déclarées dans les traits imbriqués
Les traits vendor sont ignorés.
Méthodes surchargées
Si une méthode est déclarée à plusieurs niveaux, seule la version finale réellement utilisée par le modèle est copiée.
Priorité :
- méthode déclarée dans le modèle
- méthode déclarée dans un trait directement utilisé par le modèle
- méthode déclarée dans un trait imbriqué
Les anciennes versions surchargées sont supprimées de leurs traits sources lorsqu’elles deviennent inutiles.
Suppression des traits vides
Lorsqu’un ancien trait ne contient plus aucune méthode après déplacement, son fichier est supprimé.
La directive use AncienTrait; est également retirée du modèle.
Les dossiers vides dans app/Models sont supprimés automatiquement en fin de traitement.
Suppression des traits inutilisés
La commande peut également supprimer les traits présents dans app/Models qui ne sont plus utilisés par aucun modèle.
Attention : un trait est considéré comme inutilisé uniquement s’il n’est utilisé directement ou récursivement par aucun modèle Eloquent détecté dans app/Models.
Imports
La commande conserve les imports nécessaires, y compris les alias :
Les classes situées dans le même namespace que la méthode source sont également ajoutées automatiquement au trait généré si nécessaire.
Exemple
Avant :
Après :
Sécurité
Une fois la commande exécutée, vérifier les messages d’informations de la commande :
-
Si pour un modèle est affiché le message « Trait conservé car il contient encore des méthodes », c’est peut-être parce que ce trait contient des relations qui n’ont pas pu être identifiées en tant que telles et qui doivent donc être déplacées manuellement.
- Si pour un modèle est affiché un message en rouge, c’est qu’une erreur a empêché le traitement de ce modèle. Une révision manuelle est alors nécessaire.
Une fois les corrections effectuées, exécutez la commande composer dump et corrigez l’erreur qui remonte. Il se peut
par exemple que deux relations portant le même nom aient été rapatriées dans le trait Relations d’un modèle. Effectuez
cette étape jusqu’à ce qu’il n’y ait plus d’erreur.
Optionnellement, faites une vérification avec le package axn/laravel-models-scanner.
Enfin, exécutez la commande pint pour supprimer les blancs laissés par les déplacements ainsi que les imports non utilisés.
