tcgunel/netgsm

Laravel Netgsm通道集成。

v3.0.3 2024-05-30 07:52 UTC

README

License Buy us a tree PHP Composer

Laravel Netgsm通道集成 (Laravel 7.x|8.x|9.x|10.x)

这是一个专为使用Laravel轻松快速开始使用Netgsm服务而开发的包。它已准备支持Netgsm提供的所有方法(XML POST和HTTP GET)。

目前仅针对SMS服务进行开发,对于其他服务,如果需要也会进行开发。

SMS待办事项列表

  • SMS发送
  • SMS取消
  • SMS查询
  • OTP SMS
  • 闪光SMS
  • 接收SMS
  • 发送者名称查询
  • 字符计算
  • 许可/黑名单

账户API待办事项列表

  • 信用查询
  • 套餐活动查询

需求

安装

  1. 下载包
composer require TCGunel/netgsm
  1. 可以可选地获取config文件
php artisan vendor:publish --tag=netgsm-config

以下设置可以进行;

  • (string) username => 通用要使用的账户的用户名信息。

  • (string) password => 通用要使用的账户的密码信息。

  • (bool) log => 激活日志记录,api进行的每个操作都将记录。

  • (string) service => Xml或http。

  • (bool) encoding => 开启或关闭土耳其语支持。发送的SMS中的字符计算将根据此设置而变化。 参考

  • (string) header => 如果有消息标题信息,则输入,否则使用为username输入的号码。

  • (string) filter => 如果要应用许可数据过滤器,则发送'1'。 参考

  • (string) bayikodu => 如果有代理代码。

  1. 当日志激活时,为了发布必要的迁移文件,
php artisan vendor:publish --provider="TCGunel\Netgsm\NetgsmServiceProvider" --tag="migrations"

Lumen兼容性

尚未在Lumen上进行测试。

SMS发送示例

1:n 发送

    $sms = new \TCGunel\Netgsm\SendSms\SendSms();
    
    $sms->setMsg('MESAJ İÇERİĞİ');
    
    // Tek numaraya gönder.
    $sms
    
        ->setMsg('MESAJ İÇERİĞİ'); // Mesaj İçeriği
        
        ->setGsm(5554443322)
        
         //->setGsm([5554443322, 1112223322]);  // Birden fazla numaraya gönder. Son çağırılan setGsm değerleri kullanılır.
         
         //->setEncoding('1');  // Opsiyonel. Boş string TR destek kapat veya '1' ile aç.
         
         //->setStartdate('011220210100');  // Opsiyonel. ddMMyyyyHHmm formatında gönderme tarihi.
         
         //->setStopdate('011220212359');  // Opsiyonel. ddMMyyyyHHmm iki tarih arası gönderimlerde bitiş tarihi.
         
         //->setBayikodu('?');  // Opsiyonel. Bayi üyesi ise bayiye ait kod.
         
         //->setFilter('1');  // Opsiyonel. Dolu gönderilirse netgsm filtreniz uygulanarak yasaklı numaralara gönderim yapılmaz.
         
         //->setUsername('800800800');  // Opsiyonel. Gönderimi farklı bir hesap ile yapmak için.
         
         //->setPassword('*********');  // Opsiyonel. Gönderimi farklı bir hesap ile yapmak için.
    
    $sms->execute();

n:n 发送

一次向每个号码发送自己的消息。

->setMsg(['Mesaj 1', 'Mesaj 2', 'Mesaj 3']); // Mesaj içerikleri
        
->setGsm([5554443322, 4443332211, 3332221100])

信用查询

$creditQuery = new CreditQuery();

$creditQuery

    ->setUsername('800800800') // Opsiyonel.
    
    ->setPassword('*********'); // Opsiyonel.


$creditQuery->execute();

$creditQuery->result; // String olarak TL bakiye barındırır. E.g. 150,77

套餐查询

$packageCampaignQuery = new PackageCampaignQuery();

$packageCampaignQuery

    ->setUsername('800800800') // Opsiyonel.

    ->setPassword('*********'); // Opsiyonel.

$packageCampaignQuery->execute();

$packageCampaignQuery->result; // Hesaba bağlı tüm paket bilgisini array[] olarak barındırır.

测试

composer test

针对Windows

vendor\bin\paratest.bat

作者

许可

本项目的许可协议为MIT许可 - 请参阅LICENSE文件以获取详细信息

捐赠品

此包是Treeware。如果您在生产中使用它,那么我们要求您为世界种一棵树,以感谢我们的工作。通过为Treeware森林做出贡献,您将为当地家庭创造就业并恢复野生动物栖息地。