sendgrid php

НОВЫЙ:

• Отправляйте SMS-сообщения с помощью Twilio.

Эта библиотека позволяет быстро и легко использовать веб-API Twilio SendGrid v3 через PHP.

Версия 7.XX этой библиотеки обеспечивает полную поддержку всех конечных точек Twilio SendGrid Web API v3, включая новую версию v3 /mail/send.

Если вам нужна поддержка по использованию SendGrid, посетите Справочный центр поддержки Twilio SendGrid.

Пожалуйста, просмотрите остальную часть этого README для получения более подробной информации.

Мы ценим вашу постоянную поддержку, спасибо!

Оглавление

• Установка

• Быстрый старт

• Варианты использования

• Использование

• Объявления

• Как внести свой вклад

• Поиск неисправностей

• О

• Поддерживать

• Лицензия

Установка

Предварительные условия

• PHP версии 7.3, 7.4, 8.0 или 8.1

• Служба Twilio SendGrid: начиная с бесплатного уровня, можно отправлять до 40 000 электронных писем в течение первых 30 дней, а затем отправлять 100 электронных писем в день бесплатно навсегда или ознакомиться с нашими ценами.

• Для SMS-сообщений вам понадобится бесплатная учетная запись Twilio.

Настройка переменных среды

Обновите среду разработки, используя SENDGRID_API_KEY, например:

1. Скопируйте образец файла env в новый файл с именем .env

 cp .env.sample .env

2. Отредактируйте файл .env , включив в него ваш SENDGRID_API_KEY

3. Источник файла .env

 источник ./.env

Установить пакет

Добавьте Twilio SendGrid в файл composer.json . Если вы не используете Composer, мы настоятельно рекомендуем его. Это отличный способ управлять зависимостями в вашем PHP-приложении.

 { "require": {"sendgrid/sendgrid": "~7"
  }
}

Альтернатива: установить пакет из zip.

Если вы не используете Composer, просто загрузите и установите последнюю упакованную версию библиотеки в виде zip-архива .

⬇ Скачать упакованную библиотеку ⬇

Предыдущие версии библиотеки можно скачать прямо с GitHub.

Зависимости

• Служба Twilio SendGrid, начиная с бесплатного уровня.

• php-http-клиент без зависимостей

Быстрый старт

Включите соответствующие строки снизу вверху каждого примера в зависимости от вашего метода установки:

 <?php// Раскомментируйте следующую строку, если вы используете загрузчик зависимостей (например, Composer) (рекомендуется)// требуется '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]", "Пример пользователя");$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() . «н»;
} catch (Exception $e) {echo 'Пойманное исключение:'. $e->getMessage() "n";
}

Конструктор SendGridMail создает для вас объект персонализации. Вот пример того, как добавить к нему.

Общее использование веб-API версии 3 (с плавным интерфейсом)

 $apiKey = getenv('SENDGRID_API_KEY'); $sg = new SendGrid($apiKey); попробуйте {$response = $sg->client->suppression()->bounces()->get(); напечатайте $response- >Код статуса(). "n";print_r($response->headers());print $response->body() . «н»;
} catch (Exception $e) {echo 'Пойманное исключение: '.  $e->getMessage(). «н»;
}

Общее использование веб-API версии 3 (без Fluent интерфейса)

 $apiKey = getenv('SENDGRID_API_KEY');$sg = new SendGrid($apiKey);попробуйте {$response = $sg->client->_("suppression/bounces")->get();print $response- >Код статуса(). "n";print_r($response->headers());print $response->body() . «н»;
} catch (Exception $e) {echo 'Пойманное исключение:'.  $e->getMessage(). «н»;
}

Варианты использования

Примеры распространенных случаев использования API, например, как отправить электронное письмо с шаблоном транзакции.

Использование

• Документация Twilio SendGrid

• Общая документация по использованию библиотеки

• Пример кода

Объявления

v7 вышла! Подробности смотрите в примечаниях к выпуску.

Все обновления этой библиотеки документированы в нашем CHANGELOG и выпусках.

Как внести свой вклад

Мы поощряем вклад в наши библиотеки (возможно, вы даже получите несколько отличных подарков). Подробности см. в нашем руководстве ПО ВНЕСЕНИЮ ВКЛАДОВ.

Быстрые ссылки:

• Запрос функции

• Отчеты об ошибках

• Улучшения в кодовой базе

• Обзор запросов на извлечение

Поиск неисправностей

Пожалуйста, ознакомьтесь с нашим руководством по устранению распространенных проблем с библиотекой.

О

sendgrid-php поддерживается и финансируется Twilio SendGrid, Inc. Названия и логотипы sendgrid-php являются торговыми марками Twilio SendGrid, Inc.

Поддерживать

Для получения поддержки продукта посетите Справочный центр поддержки Twilio SendGrid.

Лицензия

Лицензия MIT (MIT)