> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Invio di email
> Basi dell'invio email con la classe Mailable di Laravel, email Markdown e invio in coda.
## Le funzionalità email di Laravel
Le funzionalità email di Laravel sono costruite su [Symfony Mailer](https://symfony.com/doc/current/mailer.html) e supportano driver come SMTP, Mailgun, Postmark, Resend, Amazon SES, sendmail.
SwiftMailer è stato dismesso. Da Laravel 9 si usa Symfony Mailer.
Configura in `config/mail.php`. Nel `.env` scegli il driver.
```ini theme={null}
MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=your-username
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
```
## Creare una Mailable
Ogni email inviata è rappresentata da una classe "Mailable".
```shell theme={null}
php artisan make:mail OrderShipped
```
In `app/Mail/`.
## Configurazione della Mailable
Contiene `envelope()`, `content()`, `attachments()`.
```php theme={null}
[
'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
'name' => env('MAIL_FROM_NAME', 'Example'),
],
```
### Corpo del messaggio
`content()` indica una vista Blade. Le proprietà `public` del costruttore sono disponibili nella vista.
```php theme={null}
public function content(): Content
{
return new Content(
view: 'mail.orders.shipped',
);
}
```
Vista Blade (`resources/views/mail/orders/shipped.blade.php`):
```blade theme={null}
Il tuo ordine è stato spedito
Numero ordine: {{ $order->id }}
Totale: € {{ number_format($order->total) }}
Grazie per il tuo ordine.
```
Puoi passare dati esplicitamente con `with` (proprietà `protected`/`private`).
```php theme={null}
public function __construct(
protected Order $order,
) {}
public function content(): Content
{
return new Content(
view: 'mail.orders.shipped',
with: [
'orderId' => $this->order->id,
'total' => $this->order->total,
],
);
}
```
## Invio
Con la facade `Mail`, usa `to()` e `send()`.
```mermaid theme={null}
flowchart TD
A["Mail::to()->send(new OrderShipped())"] --> B{"Implementa
ShouldQueue?"}
B -- "No" --> C["Invio sincrono
al Mailer"]
B -- "Sì" --> D["In coda
invio in background"]
D --> C
C --> E{"Driver MAIL"}
E --> F["smtp"]
E --> G["ses / mailgun
/ postmark"]
E --> H["log
(sviluppo)"]
```
```php theme={null}
order_id);
Mail::to($request->user())->send(new OrderShipped($order));
return redirect('/orders');
}
}
```
CC e BCC:
```php theme={null}
Mail::to($request->user())
->cc($ccUsers)
->bcc($bccUsers)
->send(new OrderShipped($order));
```
Con un mailer specifico:
```php theme={null}
Mail::mailer('postmark')
->to($request->user())
->send(new OrderShipped($order));
```
## Invio via coda
```php theme={null}
Mail::to($request->user())->queue(new OrderShipped($order));
```
Con le code serve la configurazione e il worker attivo.
Con delay:
```php theme={null}
Mail::to($request->user())
->later(now()->plus(minutes: 10), new OrderShipped($order));
```
Se la Mailable implementa `ShouldQueue`, anche `send()` mette in coda.
```php theme={null}
use Illuminate\Contracts\Queue\ShouldQueue;
class OrderShipped extends Mailable implements ShouldQueue
{
// ...
}
```
### Connection e coda tramite attribute PHP
Con gli attribute PHP dichiari connection e coda a livello di classe.
```php theme={null}
use Illuminate\Queue\Attributes\Connection;
use Illuminate\Queue\Attributes\Queue;
#[Connection('sqs')]
#[Queue('emails')]
class OrderShipped extends Mailable implements ShouldQueue
{
// ...
}
```
## Email Markdown
Con il Markdown usi i template Blade responsive di Laravel.
```shell theme={null}
php artisan make:mail OrderShipped --markdown=mail.orders.shipped
```
```php theme={null}
use Illuminate\Mail\Mailables\Content;
public function content(): Content
{
return new Content(
markdown: 'mail.orders.shipped',
with: [
'url' => route('orders.show', $this->order),
],
);
}
```
Template Markdown:
```blade theme={null}
# Il tuo ordine è stato spedito
Ti informiamo che il tuo ordine è stato spedito.
Vedi ordine
Grazie,
{{ config('app.name') }}
```
Componenti disponibili:
| Componente | Descrizione |
| ------------------ | ------------------------------------------------------ |
| `` | Pulsante link (`color`: `primary`, `success`, `error`) |
| `` | Riquadro evidenziato |
| `` | Tabella in stile Markdown |
Le email Markdown generano automaticamente anche la versione text.
## Anteprima delle email
Restituendo l'istanza Mailable da una route puoi visualizzare l'email nel browser.
```php theme={null}
Route::get('/mailable', function () {
$order = App\Models\Order::first();
return new App\Mail\OrderShipped($order);
});
```
## Email in sviluppo locale
Per non inviare email reali in sviluppo, usa [Mailpit](https://github.com/axllent/mailpit).
```ini theme={null}
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
```
Laragon e Laravel Herd includono Mailpit di default.
Con il driver `log` le email vengono scritte nel file di log: il modo più semplice per verificarle.
```ini theme={null}
MAIL_MAILER=log
```
## Riepilogo
| Obiettivo | Metodo |
| -------------------- | --------------------------------- |
| Creare Mailable | `php artisan make:mail ClassName` |
| Impostare mittente | `envelope()` → `from` |
| Usare template Blade | `content()` → `view` |
| Usare Markdown | `content()` → `markdown` |
| Inviare | `Mail::to()->send()` |
| In coda | `Mail::to()->queue()` |
| Ritardato | `Mail::to()->later()` |
## Related topics
- [Eventi e listener](/it/events.md)
- [Tutorial - Laravel Console Starter](/it/packages/laravel-console-starter/tutorial.md)
- [Contracts (contratti)](/it/contracts.md)
- [Reset della password](/it/passwords.md)
- [Costruire una SPA con Inertia.js](/it/blog/inertia-introduction.md)