> ## 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

> Starter kit Laravel incentrato sui comandi Artisan. Esegue schedulazioni con GitHub Actions e invia gli output tramite notifiche.

## Panoramica

[laravel-console-starter](https://github.com/invokable/laravel-console-starter) è uno starter kit che accelera lo sviluppo di applicazioni Laravel centrate su comandi Artisan personalizzati.

Invece di creare uno strumento CLI standalone, ti permette di costruire rapidamente applicazioni console che sfruttano l'intero ecosistema Laravel (dependency injection, notifiche, scheduling, testing). Il caso d'uso di base è schedulare l'esecuzione con GitHub Actions e inviare i risultati tramite notifiche via email, Slack o simili.

## Requisiti

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

## Installazione

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

Struttura principale delle directory dopo l'installazione:

```
my-app/
├── app/Console/Commands/   # I comandi Artisan personalizzati
├── .github/workflows/
│   └── cron.yml            # Esempio di schedulazione con GitHub Actions
├── config/                 # Configurazione dell'applicazione
└── routes/console.php      # Registrazione dei comandi
```

## Caratteristiche principali

<Columns cols={3}>
  <Card title="Focus su app console" icon="terminal">
    Elimina l'overhead lato web, offrendo una configurazione focalizzata sullo sviluppo dei comandi Artisan.
  </Card>

  <Card title="Scheduling con GitHub Actions" icon="clock">
    Nessun cron sul server. `.github/workflows/cron.yml` è incluso con una configurazione di esempio pronta all'uso.
  </Card>

  <Card title="Sfrutta l'ecosistema Laravel" icon="layers">
    Puoi usare direttamente le tante funzionalità di Laravel: notifiche, client HTTP, testing, container DI e altro.
  </Card>
</Columns>

## Quick start

### Creare un comando

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

Viene generato `app/Console/Commands/Hello.php`. Implementa la logica nel metodo `handle()` ed esegui il comando.

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

### Schedulare l'esecuzione con GitHub Actions

Modifica `.github/workflows/cron.yml` e imposta il comando da eseguire e la pianificazione.

```yaml theme={null}
on:
  schedule:
    - cron: '0 0 * * *'  # Ogni giorno a mezzanotte 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
```

### Inviare notifiche

Per inviare il risultato del comando come notifica, crea una classe con `make:notification` e invia tramite la facade `Notification`.

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

```php theme={null}
Notification::route('mail', 'admin@example.com')
    ->notify(new TaskCompleted('Elaborazione completata'));
```

<Tip>
  Se ti serve configurare canali di notifica (email, Slack, ecc.), pubblica i file di configurazione con `php artisan config:publish mail` o `php artisan config:publish services`.
</Tip>

## Idee per applicazioni

Alcune idee di applicazioni che puoi costruire con questo starter kit.

<AccordionGroup>
  <Accordion title="Monitoraggio e analisi">
    * Monitoraggio uptime di siti web e alert Slack
    * Report di utilizzo delle risorse server via email
    * Verifica della scadenza dei certificati SSL e notifica
    * Monitoraggio dei tempi di risposta delle API con alert
    * Tracciamento delle variazioni di prezzo dei competitor e notifica Discord
  </Accordion>

  <Accordion title="Finanza e business">
    * Invio via email dei ricavi di Google AdSense
    * Notifica dei costi AWS su Discord
    * Aggiornamento giornaliero del portafoglio crypto su Discord
    * Alert sui prezzi delle azioni su canali Slack
    * Promemoria delle scadenze di pagamento delle fatture
    * Generazione e distribuzione di report spese mensili
  </Accordion>

  <Accordion title="Elaborazione dati e reportistica">
    * Pulizia dei file di log vecchi e report sullo storage
    * Sincronizzazione dati tra API diverse e notifica del risultato
    * Import di dati CSV ed elaborazione con notifica
    * Export periodici di dati e upload su storage cloud
  </Accordion>

  <Accordion title="Contenuti e marketing">
    * Controllo dei link rotti di un sito web e report
    * Monitoraggio del ranking di keyword SEO con notifica di variazioni
    * Report settimanale delle metriche di performance dei post del blog
    * Aggregazione di feed RSS e notifica
  </Accordion>

  <Accordion title="Sviluppo e DevOps">
    * Alert di sicurezza sulle dipendenze delle repository GitHub
    * Report di analisi statica del codice
    * Health check dell'applicazione dopo il deploy
    * Rilevamento delle modifiche alla documentazione API con notifica
  </Accordion>

  <Accordion title="AI e altro">
    * Tool per agenti AI usando [laravel-copilot-sdk](https://github.com/invokable/laravel-copilot-sdk)
    * Server MCP locale con il pacchetto [laravel/mcp](https://github.com/laravel/mcp)
    * Monitoraggio della scadenza dei domini e alert
    * Monitoraggio delle keyword su Google Trends e notifica
    * Report personalizzato di insight sulle categorie di spesa
  </Accordion>
</AccordionGroup>

## Documentazione

<Columns cols={2}>
  <Card title="Tutorial" href="/it/packages/laravel-console-starter/tutorial" icon="book-open">
    Dall'installazione alla creazione dei comandi, dalla schedulazione con GitHub Actions all'invio di notifiche, fino a esempi pratici di app.
  </Card>
</Columns>

## Link di riferimento

* 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

- [Tutorial - Laravel Console Starter](/it/packages/laravel-console-starter/tutorial.md)
- [Come creare uno starter kit per Laravel](/it/advanced/starter-kit-creation.md)
- [Laravel Fortify e gli starter kit](/it/advanced/fortify.md)
- [Laravel Maestro — l'orchestratore per lo sviluppo degli starter kit](/it/blog/maestro-introduction.md)
- [Laravel Package Skeleton — template starter per pacchetti ufficiali](/it/blog/package-skeleton-introduction.md)