sendgrid php

新的：

• 使用 Twilio 发送 SMS 消息。

该库允许您通过 PHP 快速轻松地使用 Twilio SendGrid Web API v3。

该库的 7.XX 版本为所有 Twilio SendGrid Web API v3 端点提供全面支持，包括新的 v3 /mail/send。

如果您需要使用 SendGrid 的支持，请查看 Twilio SendGrid 支持帮助中心。

请浏览本自述文件的其余部分以获取更多详细信息。

感谢您一如既往的支持，谢谢！

目录

• 安装

• 快速入门

• 使用案例

• 用法

• 公告

• 如何贡献

• 故障排除

• 关于

• 支持

• 执照

安装

先决条件

• PHP 版本 7.3、7.4、8.0 或 8.1

• Twilio SendGrid 服务从免费级别开始，前 30 天最多发送 40,000 封电子邮件，然后每天免费发送 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 应用程序中的依赖关系的绝佳方法。

 {“要求”：{“sendgrid/sendgrid”：“〜7”
  }
}

替代方案：从 zip 安装包

如果您不使用 Composer，只需下载并安装该库的最新打包版本作为 zip 。

⬇ 下载打包库 ⬇

该库的早期版本可以直接从 GitHub 下载。

依赖关系

• Twilio SendGrid 服务，从免费级别开始

• 无依赖的 php-http-client

快速入门

根据您的安装方法，在每个示例的顶部包含下面的适当行：

 <?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]", "示例用户");$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() 。 “n”；
} catch (Exception $e) {echo '捕获异常：'。 $e->getMessage() ."n";
}

SendGridMail构造函数为您创建一个个性化对象。以下是如何添加的示例。

一般 v3 Web API 用法（具有流畅的界面）

 $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() 。 “n”；
} catch (Exception $e) {echo '捕获异常：'。  $e->getMessage()。 “n”；
}

一般 v3 Web API 用法（无流畅界面）

 $apiKey = getenv('SENDGRID_API_KEY');$sg = new SendGrid($apiKey);尝试 {$response = $sg->client->_("抑制/反弹")->get();print $response- >状态代码()。 "n";print_r($response->headers());print $response->body() 。 “n”；
} catch (Exception $e) {echo '捕获异常：'。  $e->getMessage()。 “n”；
}

使用案例

常见 API 用例的示例，例如如何使用事务模板发送电子邮件。

用法

• Twilio SendGrid 文档

• 通用库使用文档

• 示例代码

公告

v7已经发布了！有关详细信息，请参阅发行说明。

该库的所有更新都记录在我们的变更日志和版本中。

如何贡献

我们鼓励为我们的图书馆做出贡献（您甚至可能会获得一些漂亮的礼物），请参阅我们的贡献指南了解详细信息。

快速链接：

• 功能请求

• 错误报告

• 代码库的改进

• 审核拉取请求

故障排除

请参阅我们的常见库问题故障排除指南。

关于

sendgrid-php 由 Twilio SendGrid, Inc. 维护和资助。sendgrid-php 的名称和徽标是 Twilio SendGrid, Inc. 的商标。

支持

有关产品支持，请查看 Twilio SendGrid 支持帮助中心。

执照

麻省理工学院许可证 (MIT)