Guide du débutant sur la console Artisan Laravel

Artisan est l'outil de ligne de commande que Laravel utilise pour accéder à ses applications. Il fournit un certain nombre de commandes qui peuvent grandement faciliter votre processus de développement.

Donc, si vous vous demandez ce qu'il peut faire et comment commencer à le faire, ce guide est fait pour vous. Voici tout ce que vous devez savoir sur l'utilisation de la console Artisan dans Laravel.

Commencer

Dans votre terminal, tapez la commande ci-dessous dans le répertoire de votre application Laravel.

Liste des artisans $ php

Il affichera la liste des commandes disponibles.

Lorsque vous utilisez des commandes, vous pouvez les faire précéder de aider option pour afficher leurs arguments et options disponibles. Le terminal affichera une brève description de ce qu'ils font sur le côté droit.

$ PHP Artisan - Aide à servir

Conseil: Comme pour la plupart des actions de ligne de commande, la syntaxe est la suivante: commande [options] [arguments] 

Bricoler

Tinker est le REPL (ou shell interactif) que Laravel utilise. Une "boucle de lecture-évaluation-impression" (REPL) est un environnement de programmation qui prend les entrées d'un seul utilisateur, les traite et renvoie un résultat à l'utilisateur.

Vous pouvez comparer Tinker à l'utilisation de l'interpréteur Python, mais Tinker est fait sur mesure pour Laravel.

Cet environnement particulier offre de nombreux avantages, comme exécuter facilement des tests simples sur le système sans écrire constamment de fichiers.

Noter: Si vous utilisez Laravel Sail, ajoutez le naviguer et vos instructions seront exécutées dans les conteneurs Docker de votre application.

Liste des artisans de $ ./sail

Comment installer Tinker

Par défaut, votre application Laravel est fournie avec Tinker. Si vous l'avez déjà désinstallé, vous pouvez l'ajouter à nouveau via compositeur.

$ composer nécessite laravel / tinker

Commandes de saisie

Tinker vous permet d'interagir avec l'ensemble de votre application. Pour commencer à utiliser Tinker, tapez:

$ php artisan bricoler

Vous êtes ensuite accueilli avec le tinker shell.

En rapport: Comment manipuler du texte en PHP avec ces 9 fonctions

Tinker a une liste d'autorisation de commandes qui détermine quelles commandes peuvent être exécutées dans son shell. Pour développer cette liste, vous pouvez accéder à la /vendor/laravel/tinker/config répertoire qui contient bricoler.php.

Vous pouvez modifier ce fichier dans votre éditeur de texte préféré pour ajouter votre commande.

'commandes' => [
// App \ Console \ Commands \ ExampleCommand:: class,
],

Définition de vos propres commandes

Outre les commandes artisanales par défaut, vous pouvez créer vos propres commandes. Lors de la création, les commandes sont automatiquement stockées dans le app / Console / Commandes annuaire.

Dans votre nouveau projet Laravel, vous ne verrez pas le /Command annuaire. C'est normal. Le dossier est créé automatiquement lorsque vous définissez une nouvelle commande. Voyez comment générer des commandes ci-dessous.

Créer des commandes

Définissez la signature de votre commande et une description de la classe. Dans le fichier de classe de la commande, vous définirez également ses arguments. Prenons cet exemple:

$ php artisan make: commande GetDailySales

Le fichier ci-dessous est généré automatiquement lors de l'exécution. Vous pouvez placer votre logique de commande dans la méthode handle puisqu'elle est appelée lorsque la commande s'exécute.

php 
 namespace App \ Console \ Commands; 
 use Illuminate \ Console \ Command; 
 class GetDailySales extend Command 
 {
 / ** 
 * Le nom et signature de la commande de la console. 
 * 
 * @var string 
 * / 
 protected $ signature = 'command: name'; 
 / ** 
 * Le description de la commande de la console. 
 * 
 * @var string 
 * / 
 protected $ description = 'Description de la commande'; 
 / ** 
 * Créer une nouvelle instance de commande. 
 * 
 * @return void 
 * / 
 publicfunction__construct () 
 {
 parent:: __construct (); 
} 
 / ** 
 * Exécuter la console commande. 
 * 
 * @return int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Commandes de fermeture

Vous pouvez contraster la fermeture commandes pour avoir des fermetures d'itinéraire définies au lieu d'utiliser des contrôleurs. De même, au lieu de créer des classes de commandes (comme nous l'avons fait dans la section "Création de commandes"), vous pouvez simplement utiliser la commande fermetures.

L'avantage ici est que vous allez avoir moins de fichiers à gérer et que votre logique est plus facile à manipuler à travers.

En savoir plus: Haut niveau vs. Langages de programmation de bas niveau, expliqués

Le fichier Kernel.php définit les routes de la console vers votre application. Vous pouvez définir toutes les commandes de votre console de fermeture avec la méthode Artisan:: command dans ce fichier. La commande prend deux arguments: la signature de la commande et la fermeture à laquelle vous l'affectez.

  Artisan:: command ('report: get {day}', function ($ day) {
 $ this-> info ("Génération d'un rapport pour: {$ day}! "); 
});  

Dépendances d'indication de type

L'indication de type fait référence à la définition statique du type de données qu'une fonction doit renvoyer ou d'un argument devrait prendre. Les fermetures de commandes peuvent également indiquer les dépendances que vous devez obtenir du conteneur de service.

Décrire les fermetures de commandes

Pour ajouter une description à une fermeture de commande, utilisez le Méthode purpose () .

  
 Artisan:: commande ('text: send {user}', function ($ user) {
 //... 
}) - > objet ('Envoyer un SMS à un utilisateur '); 
 

Vous pouvez afficher une liste complète des commandes et fonctionnalités sur Laravel docs .

En savoir plus Laravel

Laravel a une forte communauté de développeurs et une documentation bien écrite à partir de son site officiel. Cela signifie que vous ne serez jamais à court d'endroits pour trouver de l'aide lorsque vous serez bloqué.

Continuez à vous entraîner avec la console artisanale, et vous réaliserez à quel point les commandes peuvent être puissantes et rapides. Cependant, Laravel n'est pas seulement la console Artisan.

Laravel 8 introduit une foule de nouvelles fonctionnalités pour améliorer votre jeu de développement Web.

8 Nouvelles fonctionnalités puissantes de développement Web dans Laravel 8

Framework PHP Laravel est maintenant à la version 8. Voici un aperçu des nouvelles fonctionnalités de développement Web auxquelles vous pouvez vous attendre.

Lire la suite

À propos de Auteur