aghanem/jawaly

使用4jawaly.net API发送短信的Laravel包

v1.08 2021-02-15 13:19 UTC

This package is auto-updated.

Last update: 2024-09-15 21:16:27 UTC


README

安装

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

composer require aghanem/jawaly

Laravel集成

打开config/app.php,并在providers数组中添加一个新条目。

Aghanem\Jawaly\SmsServiceProvider::class

向aliases数组添加新条目

'Jawaly' => Aghanem\Jawaly\Facades\Jawaly::class

这允许你使用Aghanem外观

use Jawaly;

...

Jawaly::send($message);

现在你可以使用终端中的此行将配置文件和迁移文件复制到你的项目中

php artisan vendor:publish

这将复制jawaly.php配置文件和sms日志数据库迁移。如果你在发布这些文件时遇到任何问题,只需将src/config/jawaly.php复制到你的项目配置文件中,并将src/database/migrations/*文件复制到你的项目数据库迁移文件夹中。

配置

你必须在配置文件中更改用户名和密码(你可以将它们放在.env文件中,如定义所示)。使用unicode编码会更好,所以让它为true以使用unicode来更好地编码阿拉伯语消息。

你可以在这里设置默认的发件人。

你可以使用文件或数据库来存储你的消息日志,如果你使用数据库,你必须在发布包文件后迁移你的数据库。

用法

你可以直接使用外观。

Jawaly::send($message);

你可以以两种方式设置号码

Jawaly::send($message, $numbers);

Jawaly::setTo($numbers)->send($message);

你可以以两种方式设置发件人姓名

Jawaly::send($message, $numbers, $sender);

Jawaly::setFrom($sender)->send($message);

信用

此方法不接受任何参数,你可以简单地使用它

Jawaly::getCredits();

这将返回一个数组,其中第二个元素包含信用(如果第一个元素为true),或者如果第一个元素为false,则包含响应消息的第二个元素。

短信日志

如果你在jawaly.php配置文件中将数据库用作日志容器,每次发送消息时都会将日志存储在sms_log表中。如果你使用文件作为日志容器,这将在storage/logs/jawaly.log中存储发送日志。