README

使用 epochta 服务 epochta 发送短信的包

安装

启动

composer require "fessnik/laravel-epochta-sms"

对于 Laravel < v5.5 !

在 ServiceProvider 的 providers 数组中添加 (文件 config/app.php)

Fomvasss\EpochtaService\SmsServiceProvider::class,

为了使用门面，在 aliases 数组中添加字符串

'Sms' => Fessnik\EpochtaService\Facade\Sms::class,

发布配置

php artisan  vendor:publish --provider="Fessnik\EpochtaService\SmsServiceProvider" --tag=epochta-sms-config

如果您计划保存已发送短信及其状态的信息，请添加迁移

php artisan migrate --path=vendor/fessnik/laravel-epochta-sms/database/migrations

如果您改变主意，那么

php artisan migrate:rollback --path=vendor/fessnik/laravel-epochta-sms/database/migrations

使用方法

! 如果在配置中设置了 use_db == true - 以下方法将信息写入数据库表。

使用 Sms 类

<?php
use Fomvasss\EpochtaService\Sms;

class MyClass
{
	protected $sms;
	
	public function __construct(Sms $sms)
	{
		$this->sms = $sms;
	}
	
	public function run()
	{
		$r = $this->sms->account()->getUserBalance('RUB'); // получить баланс счета - array['balance_currency', ...]
		$r = $this->sms->stat()->sendSms('test sms text', '380656565656'); // отправить
		$r = $this->sms->stat()->sendSms('Text sms', '380656565656', 'Sender-name', '2017-10-31 16:08:00', '6'); // отправить
		$r = $this->sms->stat()->getCampaignInfo(96972041); // получить инфо об отправке
		
		// Need db table
		$sms = EpochtaSms::find(2);
		$r = $this->sms->stat()->smsDbResend($sms); // отправить повторно, при этом записать в поле `resend_sms_id` текущей модели, значиние новой `sms_id`
		$r = $this->sms->stat()->getGeneralStatus($sms); // пулучить статус в виде строки с конфига
		
		$r = $this->sms->stat()->smsDbUpdateStatuses(); // обновить все статусы, смс в которых еще нет конечного статуса
		$r = $this->sms->stat()->smsDbResendUndelivered(5, 10, 3); // отправить повторно все не доставленные
	}
}

使用 Sms 门面

<?php
    Sms::account()->getUserBalance();
    Sms::stat()->sendSms('test sms text', '380656565656');
    Sms::stat()->sendSms('test sms text', '380656565656', 'SenderTest2', '2017-10-31 16:08:00', '6');
    Sms::stat()->getCampaignInfo(96972041);
    Sms::stat()->getAllCampaignInfoFromDb();

例如，您可以在 CRON 任务 (app/Console/Kernel.php) 中使用方法 getAllCampaignInfoFromDb() 更新短信状态

<?php
    $schedule->call(function () {
        if (env('SMS_UPDATE_STATUS')) {
			\Sms::stat()->smsDbUpdateStatuses();
        }
    })->cron('* * * * * *');

使用事件

发送短信之前 (字段: attributes - 短信数据数组)

\Fomvasss\EpochtaService\Events\BeforeSendingSmsEvent

发送短信之后 (字段: attributes - 短信数据数组，sendingResult - 发送结果，model - 已保存短信模型)

\Fomvasss\EpochtaService\Events\AfterSendingSmsEvent

fessnik / laravel-epochta-sms

维护者

详细信息