> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Console Starter

> Kit de démarrage Laravel centré sur les commandes artisan. Exécution planifiée via GitHub Actions, envoi des résultats par notifications.

## Vue d'ensemble

[laravel-console-starter](https://github.com/invokable/laravel-console-starter) est un kit de démarrage qui accélère le développement d'applications Laravel centrées sur les commandes artisan personnalisées.

Plutôt que de construire un outil CLI autonome, vous pouvez rapidement bâtir des applications console tirant parti de tout l'écosystème du framework Laravel (injection de dépendances, notifications, planification, tests). Le workflow de base consiste à exécuter les commandes de manière planifiée avec GitHub Actions et à envoyer les résultats par notifications (e-mail, Slack, etc.).

## Prérequis

* PHP `^8.3`
* Laravel Framework `^13.0`
* Laravel Installer `^5.24`

## Installation

```bash theme={null}
laravel new --using=revolution/laravel-console-starter --no-interaction my-app
```

Structure principale des répertoires après installation :

```
my-app/
├── app/Console/Commands/   # Emplacement des commandes artisan personnalisées
├── .github/workflows/
│   └── cron.yml            # Exemple de planification GitHub Actions
├── config/                 # Configuration de l'application
└── routes/console.php      # Enregistrement des commandes
```

## Principales caractéristiques

<Columns cols={3}>
  <Card title="Spécialisé pour les applications console" icon="terminal">
    Configuration qui élimine la surcharge liée au web et vous permet de vous concentrer sur le développement de commandes artisan.
  </Card>

  <Card title="Planification via GitHub Actions" icon="clock">
    Pas besoin de cron sur le serveur. Un exemple de configuration `.github/workflows/cron.yml` est inclus dès le départ.
  </Card>

  <Card title="Écosystème Laravel exploitable" icon="layers">
    Notifications, client HTTP, tests, conteneur DI : vous utilisez telles quelles toutes les fonctionnalités riches de Laravel.
  </Card>
</Columns>

## Démarrage rapide

### Créer une commande

```bash theme={null}
php artisan make:command Hello --command=hello
```

`app/Console/Commands/Hello.php` est généré. Implémentez la logique dans la méthode `handle()`, puis exécutez la commande.

```bash theme={null}
php artisan hello
```

### Exécution planifiée via GitHub Actions

Modifiez `.github/workflows/cron.yml` pour configurer la commande à exécuter et sa planification.

```yaml theme={null}
on:
  schedule:
    - cron: '0 0 * * *'  # Tous les jours à 0h UTC

jobs:
  cron:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: shivammathur/setup-php@v2
        with:
          php-version: 8.5
      - run: composer install --no-dev -q
      - run: cp .env.example .env
      - run: php artisan key:generate
      - run: php artisan your:command
```

### Envoyer une notification

Pour envoyer le résultat d'exécution d'une commande sous forme de notification, créez une classe avec `make:notification` et envoyez-la via la façade `Notification`.

```bash theme={null}
php artisan make:notification TaskCompleted
```

```php theme={null}
Notification::route('mail', 'admin@example.com')
    ->notify(new TaskCompleted('Le traitement est terminé'));
```

<Tip>
  Si la configuration d'un canal de notification (e-mail, Slack, etc.) est nécessaire, publiez les fichiers de configuration via `php artisan config:publish mail` ou `php artisan config:publish services`.
</Tip>

## Idées d'applications

Voici des idées d'applications que vous pouvez construire avec ce kit de démarrage.

<AccordionGroup>
  <Accordion title="Surveillance et analyse">
    * Surveillance de la disponibilité d'un site web et alertes Slack
    * Rapport d'utilisation des ressources serveur par e-mail
    * Vérification de la date d'expiration des certificats SSL et notifications
    * Surveillance des temps de réponse d'API et alertes
    * Suivi des variations de prix des concurrents et notifications Discord
  </Accordion>

  <Accordion title="Finance et affaires">
    * Envoi par e-mail des revenus Google AdSense
    * Notification des coûts AWS sur Discord
    * Mise à jour quotidienne du portefeuille crypto vers Discord
    * Alertes de cours boursier sur un canal Slack
    * Rappels d'échéance de paiement des factures
    * Génération et distribution d'un rapport mensuel de dépenses
  </Accordion>

  <Accordion title="Traitement de données et rapports">
    * Nettoyage des anciens fichiers de logs et rapport de stockage
    * Synchronisation de données entre différentes API et notification du résultat
    * Import et traitement de données CSV avec notification du résultat
    * Export périodique de données et upload vers du stockage cloud
  </Accordion>

  <Accordion title="Contenu et marketing">
    * Vérification des liens brisés d'un site web et rapport
    * Surveillance du classement de mots-clés SEO et notification des variations
    * Rapport hebdomadaire des indicateurs de performance des articles de blog
    * Agrégation de contenus de flux RSS et notifications
  </Accordion>

  <Accordion title="Développement et DevOps">
    * Alertes de sécurité sur les dépendances des dépôts GitHub
    * Rapport d'analyse statique du code
    * Health check de l'application après déploiement
    * Détection des changements dans la documentation d'API et notifications
  </Accordion>

  <Accordion title="IA et divers">
    * Outil d'agent IA utilisant [laravel-copilot-sdk](https://github.com/invokable/laravel-copilot-sdk)
    * Serveur MCP local utilisant le package [laravel/mcp](https://github.com/laravel/mcp)
    * Surveillance des dates d'expiration de domaines et alertes
    * Surveillance de mots-clés Google Trends et notifications
    * Rapport d'analyse personnel par catégorie de dépenses
  </Accordion>
</AccordionGroup>

## Documentation

<Columns cols={2}>
  <Card title="Tutoriel" href="/fr/packages/laravel-console-starter/tutorial" icon="book-open">
    De l'installation à la création de commandes, en passant par la planification GitHub Actions, l'envoi de notifications et des exemples d'applications concrètes.
  </Card>
</Columns>

## Liens de référence

* GitHub : [invokable/laravel-console-starter](https://github.com/invokable/laravel-console-starter)
* DeepWiki : [invokable/laravel-console-starter](https://deepwiki.com/invokable/laravel-console-starter)


## Related topics

- [Tutoriel - Laravel Console Starter](/fr/packages/laravel-console-starter/tutorial.md)
- [Créer un starter kit Laravel](/fr/advanced/starter-kit-creation.md)
- [Laravel Fortify et les starter kits](/fr/advanced/fortify.md)
- [Laravel Maestro — l'orchestrateur de développement des starter kits](/fr/blog/maestro-introduction.md)
- [Laravel Chisel — la bibliothèque de scripts post-installation des starter kits](/fr/blog/chisel-introduction.md)