README

Laravel Twilio API 集成

安装

首先通过 Composer 安装此包。在终端中运行以下命令

composer require id-pal/tw-sms-adapter

这将为您注册两个新的 artisan 命令

• twilio:sms
• twilio:call

并将这些对象可解析地从 IoC 容器中解析出来

• Aloha\Twilio\Manager (别名 twilio)
• Aloha\Twilio\TwilioInterface (解析一个 Twilio 对象，这是由 Manager 创建的默认连接对象)。

如果您喜欢，还有一个 Facade 类可供使用。在您的 app.php 配置文件中，如果您想使用简短的类名，请将以下行添加到 aliases 数组中

'Twilio' => 'Aloha\Twilio\Support\Laravel\Facade',

您可以使用终端命令将默认配置文件发布到 config/twilio.php

php -r "copy('vendor/aloha/twilio/src/config/config.php', 'config/twilio.php');"

外观

外观具有与 Aloha\Twilio\TwilioInterface 完全相同的方法。首先，在文件顶部包含 Facade 类

use Twilio;

使用默认的 twilio 配置文件 发送消息

Twilio::message($user->phone, $message);

一个额外的功能是您可以定义要使用的设置（以及哪个发送者电话号码）

Twilio::from('call_center')->message($user->phone, $message);
Twilio::from('board_room')->message($boss->phone, 'Hi there boss!');

在您的 twilio 配置文件 中定义多个条目以利用此功能。

用法

创建一个 Twilio 对象。该对象实现了 Aloha\Twilio\TwilioInterface。

$twilio = new Aloha\Twilio\Twilio($accountId, $token, $fromNumber);

发送短信

$twilio->message('+18085551212', 'Pink Elephants and Happy Rainbows');

创建通话

$twilio->call('+18085551212', 'http://foo.com/call.xml');

一次性生成通话和构建消息

$twilio->call('+18085551212', function (\Twilio\TwiML\VoiceResponse $message) {
    $message->say('Hello');
    $message->play('https://api.twilio.com/cowbell.mp3', ['loop' => 5]);
});

或者使用任何 Twiml 描述来拨打电话，您可以传递任何 Twiml 对象

$message = new \Twilio\TwiML\VoiceResponse();
$message->say('Hello');
$message->play('https://api.twilio.com/cowbell.mp3', ['loop' => 5]);

$twilio->call('+18085551212', $message);

访问配置的 Twilio\Rest\Client 对象

$sdk = $twilio->getTwilio();

您也可以通过外观来访问它

$sdk = Twilio::getTwilio();

传递尽可能多的可选参数

如果您想将额外的可选参数传递给 messages->sendMessage(...) 方法 来自 Twilio SDK，您可以通过将它们添加到 message 方法来实现。所有参数都传递下去，并且 from 字段从配置中预先添加。

$twilio->message($to, $message, $mediaUrls, $params);
// passes all these params on.

对于 调用方法，也是如此。

$twilio->call($to, $message, $params);
// passes all these params on.

示例类

有一个 TwilioInterface 的示例实现：Aloha\Twilio\Dummy。此类允许您在需要快速集成测试的情况下注入此替代实现。

日志装饰器

还有一个可用的类：Aloha\Twilio\LoggingDecorator。此类包装任何 TwilioInterface 对象并记录 Twilio 将为您做什么。它还接受一个 Psr\Log\LoggerInterface 对象（如 Monolog）用于记录。

默认情况下，服务提供商不会使用 LoggingDecorator 包装对象，但在您需要的情况下，它是可用的。一个可能的用例是构建一个记录将要发生的事情但不实际调用 Twilio 的 TwilioInterface 对象（使用 Dummy 类）。

if (getenv('APP_ENV') === 'production') {
    $twilio = $container->make(\Aloha\Twilio\Manager::class);
} else {
    $psrLogger = $container->make(\Psr\Log\LoggerInterface::class);
    $twilio = new LoggingDecorator($psrLogger, new \Aloha\Twilio\Dummy());
}

// Inject it wherever you want.
$notifier = new Notifier($twilio);

致谢

• Hannes Van De Vreken
• Travis Ryan
• 所有贡献者

许可

laravel-twilio 是开源软件，采用 MIT 许可证 许可