جديد:
إرسال رسائل SMS مع Twilio.
تتيح لك هذه المكتبة استخدام Twilio SendGrid Web API v3 بسرعة وسهولة عبر PHP.
يوفر الإصدار 7.XX من هذه المكتبة الدعم الكامل لجميع نقاط نهاية Twilio SendGrid Web API v3، بما في ذلك v3 /mail/send الجديد.
إذا كنت بحاجة إلى دعم باستخدام SendGrid، فيرجى مراجعة مركز مساعدة دعم Twilio SendGrid.
يرجى تصفح بقية هذا الملف التمهيدي للحصول على مزيد من التفاصيل.
نحن نقدر دعمكم المستمر، شكرا لكم!
تثبيت
بداية سريعة
حالات الاستخدام
الاستخدام
إعلانات
كيفية المساهمة
استكشاف الأخطاء وإصلاحها
عن
يدعم
رخصة
إصدار PHP 7.3 أو 7.4 أو 8.0 أو 8.1
خدمة Twilio SendGrid، بدءًا من المستوى المجاني لإرسال ما يصل إلى 40000 بريد إلكتروني لأول 30 يومًا، ثم إرسال 100 بريد إلكتروني يوميًا مجانًا إلى الأبد أو التحقق من أسعارنا.
بالنسبة للرسائل النصية القصيرة، ستحتاج إلى حساب Twilio مجاني.
قم بتحديث بيئة التطوير باستخدام SENDGRID_API_KEY، على سبيل المثال:
انسخ ملف env النموذجي إلى ملف جديد يسمى .env
cp .env.sample .env
قم بتحرير ملف .env
ليتضمن SENDGRID_API_KEY
الخاص بك
مصدر الملف .env
المصدر ./.env
أضف Twilio SendGrid إلى ملف composer.json
الخاص بك. إذا كنت لا تستخدم Composer، فنحن نوصي به بشدة. إنها طريقة ممتازة لإدارة التبعيات في تطبيق PHP الخاص بك.
{ "تتطلب": {"sendgrid/sendgrid": "~7" } }
إذا كنت لا تستخدم Composer، فما عليك سوى تنزيل أحدث إصدار من المكتبة وتثبيته كملف ZIP .
⬇ تحميل المكتبة المجمعة ⬇
يمكن تنزيل الإصدارات السابقة من المكتبة مباشرة من GitHub.
خدمة Twilio SendGrid، بدءًا من المستوى المجاني
عميل php-http-free الخالي من التبعية
قم بتضمين الأسطر المناسبة من الأسفل في أعلى كل مثال بناءً على طريقة التثبيت الخاصة بك:
<?php// قم بإلغاء التعليق على السطر التالي إذا كنت تستخدم أداة تحميل التبعية (مثل Composer) (مستحسن)// require 'vendor/autoload.php';// قم بإلغاء التعليق على السطر التالي إذا كنت لا تستخدم تبعية المُحمل (مثل Composer)، مع استبدال <PATH TO> بالمسار إلى ملف sendgrid-php.php// require_once '<PATH TO>/sendgrid-php.php';
فيما يلي الحد الأدنى من الرمز المطلوب لإرسال بريد إلكتروني. قد تجد المزيد من الأمثلة في ملف USE_CASES الخاص بنا:
$email = new SendGridMailMail();$email->setFrom("[email protected]", "Example User");$email->setSubject("الإرسال باستخدام Twilio SendGrid ممتع");$email->addTo( "[email protected]"، "مثال للمستخدم")؛$email->addContent("text/plain"، "ويسهل القيام به في أي مكان، حتى مع PHP");$email->addContent("text/html", "<strong>ويسهل القيام به في أي مكان، حتى باستخدام PHP</strong>");$sendgrid = new SendGrid(getenv('SENDGRID_API_KEY')); حاول {$response = $sendgrid->send($email);print $response->statusCode() . "n";print_r($response->headers());print $response->body() . "ن"؛ } قبض على (استثناء $e) {صدى "استثناء تم القبض عليه:". $e->getMessage() ."n"; }
يقوم مُنشئ SendGridMail
بإنشاء كائن تخصيص لك. فيما يلي مثال لكيفية الإضافة إليه.
$apiKey = getenv('SENDGRID_API_KEY');$sg = new SendGrid($apiKey);try {$response = $sg->client->suppression()->bounces()->get();print $response- >رمز الحالة (). "n";print_r($response->headers());print $response->body() . "ن"؛ } قبض على (استثناء $e) {صدى "استثناء تم القبض عليه:". $e->getMessage(). "ن"؛ }
$apiKey = getenv('SENDGRID_API_KEY');$sg = new SendGrid($apiKey);try {$response = $sg->client->_("suppression/bounces")->get();print $response- >رمز الحالة (). "n";print_r($response->headers());print $response->body() . "ن"؛ } قبض على (استثناء $e) {صدى "استثناء تم القبض عليه:". $e->getMessage(). "ن"؛ }
أمثلة على حالات استخدام واجهة برمجة التطبيقات الشائعة، مثل كيفية إرسال بريد إلكتروني باستخدام قالب المعاملات.
مستندات Twilio SendGrid
وثائق استخدام المكتبة العامة
رمز المثال
لقد تم الافراج عن v7! يرجى الاطلاع على ملاحظات الإصدار للحصول على التفاصيل.
تم توثيق جميع التحديثات لهذه المكتبة في سجل التغيير والإصدارات الخاصة بنا.
نحن نشجع المساهمة في مكتباتنا (قد تحصل أيضًا على بعض الغنيمة الرائعة)، يرجى الاطلاع على دليل المساهمة الخاص بنا للحصول على التفاصيل.
روابط سريعة:
طلب الميزة
تقارير الأخطاء
تحسينات على Codebase
مراجعة طلبات السحب
يرجى الاطلاع على دليل استكشاف الأخطاء وإصلاحها الخاص بنا لمعرفة مشكلات المكتبة الشائعة.
تتم صيانة sendgrid-php وتمويله بواسطة Twilio SendGrid, Inc.. الأسماء والشعارات الخاصة بـ sendgrid-php هي علامات تجارية مملوكة لشركة Twilio SendGrid, Inc.
للحصول على دعم المنتج، يرجى مراجعة مركز مساعدة دعم Twilio SendGrid.
رخصة معهد ماساتشوستس للتكنولوجيا (MIT)