Laravel: Artisan CLI

Artisan est l'interface en ligne de commande incluse avec Laravel. Il fournit un certain nombre de commandes utiles pour développer et gérer des applications Laravel. Ce guide détaillé vous expliquera comment utiliser Artisan pour diverses tâches avec des exemples pratiques.

Introduction à Artisan

Artisan est accessible via le terminal en utilisant la commande php artisan. Vous pouvez voir une liste de toutes les commandes disponibles en exécutant :

php artisan list

Pour obtenir de l'aide sur une commande spécifique, utilisez :

php artisan help nom-de-la-commande

Commandes Artisan de Base

1. Afficher la Version de Laravel

php artisan --version

2. Lancer le Serveur de Développement

php artisan serve

Cette commande lance un serveur de développement à http://127.0.0.1:8000.

Gestion des Bases de Données

1. Exécuter les Migrations

Pour exécuter toutes les migrations non exécutées, utilisez :

php artisan migrate

2. Annuler la Dernière Migration

php artisan migrate:rollback

3. Réinitialiser et Réexécuter Toutes les Migrations

php artisan migrate:refresh

4. Créer une Nouvelle Migration

php artisan make:migration create_nom_table --create=nom_table

Cette commande crée un fichier de migration dans le répertoire database/migrations.

Génération de Code

1. Créer un Nouveau Contrôleur

php artisan make:controller NomController

2. Créer un Nouveau Modèle

php artisan make:model NomModele

3. Créer une Nouvelle Vue

Bien que Artisan ne puisse pas créer de vues directement, vous pouvez utiliser des commandes Artisan pour créer des contrôleurs et des ressources, et ajouter manuellement des vues dans le répertoire resources/views.

Tâches Programmées

1. Créer une Nouvelle Tâche

php artisan make:command NomDeLaCommande

Cette commande crée un fichier de commande dans le répertoire app/Console/Commands.

2. Planifier des Tâches

Les tâches planifiées sont définies dans le fichier app/Console/Kernel.php. Par exemple, pour planifier une commande pour qu'elle s'exécute toutes les heures :

// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
    $schedule->command('nom:commande')->hourly();
}

Utilisation de Tinker

Tinker est un REPL (Read-Eval-Print Loop) inclus avec Laravel qui permet d'interagir avec votre application via la ligne de commande.

1. Lancer Tinker

php artisan tinker

2. Utilisation de Tinker

Par exemple, pour créer un nouvel utilisateur :

use App\Models\User;
User::create(['name' => 'John Doe', 'email' => 'john@example.com', 'password' => bcrypt('secret')]);

Développement et Débogage

1. Vider le Cache de l'Application

php artisan cache:clear

2. Vider le Cache de la Configuration

php artisan config:cache

3. Vider le Cache des Routes

php artisan route:cache

4. Vider le Cache des Vues

php artisan view:clear

Commandes Artisan Personnalisées

Vous pouvez créer vos propres commandes Artisan pour automatiser des tâches spécifiques.

1. Créer une Commande Personnalisée

php artisan make:command NomDeLaCommande

Cette commande crée un fichier dans app/Console/Commands. Modifiez ce fichier pour définir la logique de votre commande :

// app/Console/Commands/NomDeLaCommande.php
namespace App\Console\Commands;

use Illuminate\Console\Command;

class NomDeLaCommande extends Command
{
    protected $signature = 'commande:nom';
    protected $description = 'Description de la commande';

    public function __construct()
    {
        parent::__construct();
    }

    public function handle()
    {
        $this->info('Commande exécutée avec succès!');
    }
}

Conclusion

Artisan est un outil puissant qui facilite le développement et la gestion des applications Laravel. Il offre une large gamme de commandes pour accomplir diverses tâches, de la gestion des bases de données à la génération de code en passant par le débogage et l'automatisation des tâches. En maîtrisant Artisan, vous pouvez améliorer considérablement votre productivité en tant que développeur Laravel.

Pour plus de détails, consultez la documentation officielle de Laravel Artisan.