Sign inGet Started

PHP

messagebird/sdk की मदद से एक साधारण PHP स्क्रिप्ट से ईमेल भेजें। आपको एक Bird API key चाहिए: Developers > API keys में जाकर एक बनाएँ (अपना पहला ईमेल भेजें में पूरी प्रक्रिया बताई गई है), फिर इसे BIRD_API_KEY के रूप में एक्सपोर्ट करें।

1. इंस्टॉल करें

कोड उदाहरण
composer require messagebird/sdk
mkdir -p examples

SDK के लिए PHP 8.2+ ज़रूरी है और यह इंस्टॉल किए गए PSR-18 HTTP क्लाइंट को स्वचालित रूप से खोज लेता है।

2. भेजें

examples/quickstart-email.php बनाएँ ताकि जेनरेट किए गए उदाहरण का autoload पाथ सही से रिज़ॉल्व हो:

कोड उदाहरण
<?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 Bird का साझा ऑनबोर्डिंग सेंडर है और delivered@messagebird.dev एक सैंडबॉक्स प्राप्तकर्ता है जो हमेशा डिलीवर होता है: डोमेन सत्यापन की ज़रूरत नहीं। SDK आपकी key के bk_us1_ / bk_eu1_ प्रीफ़िक्स से रीजन का अनुमान लगाता है (कोई base URL कॉन्फ़िगर करने की ज़रूरत नहीं) और हर कॉल पर एक Idempotency-Key ऑटो-जेनरेट करता है, इसलिए फिर से प्रयास किए गए भेजने सुरक्षित हैं।

3. चलाएँ

कोड उदाहरण
php examples/quickstart-email.php

स्क्रिप्ट मैसेज ID और स्टेटस प्रिंट करती है:

कोड उदाहरण
em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted API का 202 है: Bird के पास मैसेज है और वह इसे एसिंक्रोनस रूप से डिलीवर करता है। इसे em_ ID से $bird->email->get($message->getId()) के ज़रिए फ़ेच करें और स्टेटस को delivered में बदलते देखें।

अगले कदम

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।