> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# E-Mail-Versand
> Erfahren Sie, wie Sie mit den Mailable-Klassen von Laravel E-Mails versenden – von den Grundlagen über Markdown-Mails bis zum Versand über Queues.
## Was ist die E-Mail-Funktion von Laravel
Die E-Mail-Funktion von Laravel basiert auf dem [Symfony Mailer](https://symfony.com/doc/current/mailer.html) und unterstützt Treiber wie SMTP, Mailgun, Postmark, Resend, Amazon SES und sendmail.
Der früher in Laravel eingesetzte SwiftMailer ist veraltet. Seit Laravel 9 wird der Symfony Mailer verwendet.
Die E-Mail-Konfiguration wird in `config/mail.php` verwaltet. Über die `.env`-Datei können Sie den verwendeten Treiber wechseln.
```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}"
```
## Eine Mailable-Klasse erstellen
In Laravel wird jede E-Mail, die die Anwendung versendet, als „Mailable“-Klasse dargestellt. Mit dem Artisan-Befehl `make:mail` erzeugen Sie eine solche Klasse.
```shell theme={null}
php artisan make:mail OrderShipped
```
Die generierte Klasse wird im Verzeichnis `app/Mail/` abgelegt.
## Mailable konfigurieren
Die generierte Mailable-Klasse besitzt die drei Methoden `envelope()`, `content()` und `attachments()`.
```php theme={null}
[
'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
'name' => env('MAIL_FROM_NAME', 'Example'),
],
```
### E-Mail-Inhalt konfigurieren
Über die Methode `content()` geben Sie das Blade-Template an. Daten, die Sie im Konstruktor als `public`-Eigenschaft setzen, stehen automatisch im Template zur Verfügung.
```php theme={null}
public function content(): Content
{
return new Content(
view: 'mail.orders.shipped',
);
}
```
Erstellen Sie das zugehörige Blade-Template (`resources/views/mail/orders/shipped.blade.php`).
```blade theme={null}
Ihre Bestellung wurde versendet
Bestellnummer: {{ $order->id }}
Gesamtbetrag: €{{ number_format($order->total, 2, ',', '.') }}
Vielen Dank für Ihre Bestellung.
```
Sie können die Daten auch explizit über den Parameter `with` übergeben. In diesem Fall sollten die Eigenschaften `protected` oder `private` sein.
```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,
],
);
}
```
## E-Mails versenden
Geben Sie den Empfänger mit der `to()`-Methode der `Mail`-Fassade an und versenden Sie die Mail mit `send()`.
```mermaid theme={null}
flowchart TD
A["Mail::to()->send(new OrderShipped())"] --> B{"ShouldQueue
implementiert?"}
B -- "Nein" --> C["Synchroner Versand
an Mailer"]
B -- "Ja" --> D["In Queue einreihen
Hintergrundversand"]
D --> C
C --> E{"MAIL-Treiber"}
E --> F["smtp"]
E --> G["ses / mailgun
/ postmark"]
E --> H["log
(Entwicklung)"]
```
```php theme={null}
order_id);
Mail::to($request->user())->send(new OrderShipped($order));
return redirect('/orders');
}
}
```
CC und BCC können ebenfalls angegeben werden.
```php theme={null}
Mail::to($request->user())
->cc($ccUsers)
->bcc($bccUsers)
->send(new OrderShipped($order));
```
Um über einen bestimmten Mailer zu versenden, verwenden Sie die Methode `mailer()`.
```php theme={null}
Mail::mailer('postmark')
->to($request->user())
->send(new OrderShipped($order));
```
## E-Mail-Versand über Queues
Da der E-Mail-Versand die Antwortzeit beeinflusst, empfiehlt es sich, ihn über eine Queue im Hintergrund abzuwickeln.
```php theme={null}
Mail::to($request->user())->queue(new OrderShipped($order));
```
Für die Nutzung von Queues muss die Queue-Konfiguration eingerichtet und ein Worker gestartet sein.
Auch ein verzögerter Versand ist möglich.
```php theme={null}
Mail::to($request->user())
->later(now()->plus(minutes: 10), new OrderShipped($order));
```
Wenn Sie in der Mailable-Klasse `ShouldQueue` implementieren, wird die Mail auch bei einem Aufruf von `send()` immer in die Queue eingereiht.
```php theme={null}
use Illuminate\Contracts\Queue\ShouldQueue;
class OrderShipped extends Mailable implements ShouldQueue
{
// ...
}
```
### Queue-Verbindung und Queue-Name per PHP-Attribut angeben
Mit PHP-Attributen können Sie Queue-Verbindung und Queue-Name direkt an der Mailable-Klasse festlegen. Statt der Methoden-Kette `on()->queue()` konfigurieren Sie diese Werte deklarativ auf Klassenebene.
```php theme={null}
use Illuminate\Queue\Attributes\Connection;
use Illuminate\Queue\Attributes\Queue;
#[Connection('sqs')]
#[Queue('emails')]
class OrderShipped extends Mailable implements ShouldQueue
{
// ...
}
```
So machen Sie in der Klassendefinition deutlich, dass diese Mailable stets an die Queue `emails` auf der SQS-Verbindung übergeben wird.
## Markdown-Mails erstellen
Mit Markdown-Mails können Sie die von Laravel bereitgestellten, schönen und responsiven HTML-Templates nutzen.
### Markdown-Mailable erzeugen
Erzeugen Sie das Mailable mit der Option `--markdown`.
```shell theme={null}
php artisan make:mail OrderShipped --markdown=mail.orders.shipped
```
Verwenden Sie in der Methode `content()` den Parameter `markdown`.
```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),
],
);
}
```
### Markdown-Templates schreiben
Verfassen Sie den E-Mail-Text mithilfe der von Laravel bereitgestellten Blade-Komponenten.
```blade theme={null}
# Ihre Bestellung wurde versendet
wir möchten Sie darüber informieren, dass Ihre Bestellung versendet wurde.
Bestellung ansehen
Vielen Dank für Ihre Nutzung.
{{ config('app.name') }}
```
Die verfügbaren Komponenten sind:
| Komponente | Beschreibung |
| ------------------ | -------------------------------------------------------------------- |
| `` | Button-Link (für `color` sind `primary`, `success`, `error` möglich) |
| `` | Hervorgehobener Panel-Bereich |
| `` | Tabelle im Markdown-Format |
Markdown-Mails erzeugen automatisch auch eine reine Textvariante. So können sie auch in E-Mail-Clients gelesen werden, die keine HTML-Mails unterstützen.
## E-Mails in der Vorschau anzeigen
Wenn Sie in einer Route eine Mailable-Instanz zurückgeben, können Sie die Mail im Browser als Vorschau ansehen. Das ist während der Entwicklung sehr praktisch.
```php theme={null}
// routes/web.php
Route::get('/mailable', function () {
$order = App\Models\Order::first();
return new App\Mail\OrderShipped($order);
});
```
## E-Mails in der lokalen Entwicklung
Damit in der Produktionsumgebung keine Mails versehentlich versendet werden, ist es hilfreich, für die lokale Entwicklung Tools wie [Mailpit](https://github.com/axllent/mailpit) einzusetzen.
```ini theme={null}
# .env (Mailpit)
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
```
In `Laragon` oder `Laravel Herd` ist Mailpit standardmäßig enthalten.
Mit dem Treiber `log` wird der Inhalt der E-Mail in die Logdatei geschrieben. Wenn Sie nur den Versand prüfen möchten, ist dies die einfachste Variante.
```ini theme={null}
MAIL_MAILER=log
```
## Zusammenfassung
| Ziel | Vorgehen |
| --------------------------- | ----------------------------------- |
| Mailable erstellen | `php artisan make:mail ClassName` |
| Absender festlegen | Parameter `from` in `envelope()` |
| Blade-Template verwenden | Parameter `view` in `content()` |
| Markdown-Template verwenden | Parameter `markdown` in `content()` |
| E-Mail versenden | `Mail::to()->send()` |
| Mit Queue versenden | `Mail::to()->queue()` |
| Verzögert versenden | `Mail::to()->later()` |
## Related topics
- [Events und Listener](/de/events.md)
- [Collections](/de/collections.md)
- [Tutorial - Laravel Console Starter](/de/packages/laravel-console-starter/tutorial.md)
- [Deferred Service Provider](/de/advanced/deferred-provider.md)
- [Laravel Cloud Hibernation (automatisches Pausieren)](/de/blog/laravel-cloud-hibernation.md)