tcgunel / netgsm
Laravel Netgsm通道集成。
v3.0.3
2024-05-30 07:52 UTC
Requires
- php: ^8.0
- ext-curl: *
- ext-simplexml: *
- ext-xmlwriter: *
- guzzlehttp/guzzle: *
- illuminate/database: *
- illuminate/notifications: *
- illuminate/support: *
- laravel/legacy-factories: *
Requires (Dev)
README
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待办事项列表
- 信用查询
- 套餐活动查询
需求
安装
- 下载包
composer require TCGunel/netgsm
- 可以可选地获取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 => 如果有代理代码。
- 当日志激活时,为了发布必要的迁移文件,
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
作者
- Tolga Can GÜNEL - 基础和项目启动
许可
本项目的许可协议为MIT许可 - 请参阅LICENSE文件以获取详细信息
捐赠品
此包是Treeware。如果您在生产中使用它,那么我们要求您为世界种一棵树,以感谢我们的工作。通过为Treeware森林做出贡献,您将为当地家庭创造就业并恢复野生动物栖息地。