PHP

Senden Sie eine E-Mail aus einem einfachen PHP-Skript mit messagebird/sdk. Sie benötigen einen Bird API-Schlüssel: Erstellen Sie einen unter Developers > API keys (Ihre erste E-Mail senden führt Sie durch den Vorgang) und exportieren Sie ihn als BIRD_API_KEY.

1. Installieren

composer require messagebird/sdk
mkdir -p examples

Das SDK erfordert PHP 8.2+ und erkennt automatisch einen installierten PSR-18 HTTP-Client.

2. Senden

Erstellen Sie examples/quickstart-email.php, damit der Autoload-Pfad des generierten Beispiels korrekt aufgelöst wird:

<?php

// Send your first email. Set BIRD_API_KEY in your environment, then run:
//   php examples/quickstart-email.php

declare(strict_types=1);

require __DIR__ . '/../vendor/autoload.php';

use MessageBird\Bird;

$bird = new Bird(getenv('BIRD_API_KEY') ?: '');

$message = $bird->email->send(
    from: 'Bird <onboarding@messagebird.dev>',
    to: ['delivered@messagebird.dev'],
    subject: 'Hello from Bird',
    html: '<p>My first Bird email.</p>',
);

echo $message->getId(), ' ', $message->getStatus(), "\n";

onboarding@messagebird.dev ist der gemeinsame Onboarding-Absender von Bird und delivered@messagebird.dev ist ein Sandbox-Empfänger, der immer zugestellt wird: keine Domain-Verifizierung nötig. Das SDK leitet die Region aus dem bk_us1_- / bk_eu1_-Präfix Ihres Schlüssels ab (keine Base-URL zu konfigurieren) und generiert pro Aufruf automatisch eine Idempotency-Key, sodass wiederholte Sendeversuche sicher sind.

3. Ausführen

php examples/quickstart-email.php

Das Skript gibt die Nachrichten-ID und den Status aus:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted ist der 202 des API: Bird hat die Nachricht und stellt sie asynchron zu. Rufen Sie sie über ihre em_-ID mit $bird->email->get($message->getId()) ab und beobachten Sie, wie der Status zu delivered wechselt.

Nächste Schritte

• PHP SDK: der vollständige Client, das Fehlermodell und die Webhook-Verifizierung.
• Ihre erste E-Mail senden: Erstellen eines API-Schlüssels und die vollständige Liste der Sandbox-Adressen.
• Sende-Domains: Verifizieren Sie Ihre eigene Domain für den Produktionsversand.
• E-Mail-API-Referenz: das vollständige Request- und Response-Schema.