Sign inGet Started

PHP

Verstuur een e-mail vanuit een gewoon PHP-script met messagebird/sdk. Je hebt een Bird API-sleutel nodig: maak er een aan in Developers > API keys (Verstuur je eerste e-mail legt de stappen uit) en exporteer deze als BIRD_API_KEY.

1. Installeren

Codevoorbeeld
composer require messagebird/sdk
mkdir -p examples

De SDK vereist PHP 8.2+ en detecteert automatisch een geïnstalleerde PSR-18 HTTP-client.

2. Versturen

Maak examples/quickstart-email.php aan zodat het autoload-pad van het gegenereerde voorbeeld correct wordt gevonden:

Codevoorbeeld
<?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 is de gedeelde onboarding-afzender van Bird en delivered@messagebird.dev is een sandbox-ontvanger die altijd aflevert: domeinverificatie is niet nodig. De SDK leidt de regio af uit het bk_us1_- / bk_eu1_-voorvoegsel van je sleutel (geen basis-URL nodig) en genereert automatisch een Idempotency-Key per aanroep, zodat herhaalde verzendingen veilig zijn.

3. Uitvoeren

Codevoorbeeld
php examples/quickstart-email.php

Het script toont het bericht-ID en de status:

Codevoorbeeld
em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted is de 202 van de API: Bird heeft het bericht en levert het asynchroon af. Haal het op via het em_-ID met $bird->email->get($message->getId()) en volg hoe de status verandert naar delivered.

Volgende stappen