afatmustafa / mutlucell
Mutlucell SMS API 包装器,用于向 Laravel 10, 9, 8, 7, 6, 5 和 4 发送短信。
Requires
- php: ^7.3|^8.0
- ext-simplexml: *
- guzzlehttp/guzzle: ^6.5.6|^7.4.5
- illuminate/support: 10.*
This package is not auto-updated.
Last update: 2024-09-24 18:39:46 UTC
README
使用此包,您可以在使用 Laravel 9.x, 8.x, 7.x, 6.x, 5.x 或 4.x 的项目中,通过 Mutlucell 基础设施发送单条或多条短信,并查询余额和 originator ID。
此分支适用于 Laravel 9。如果您想在 Laravel 8.x 上使用此包,请使用 5.x 版本 "ardakilic/mutlucell": "~5"
,在 Laravel 7.x 上使用 4.x 版本 "ardakilic/mutlucell": "~4"
,在 Laravel 6.x 上使用 3.x 版本 "ardakilic/mutlucell": "~3"
,在 Laravel 5.x 上使用 2.x 版本 "ardakilic/mutlucell": "~2"
,在 Laravel 4 上使用 1.x 版本,使用 "ardakilic/mutlucell": "~1"
标签。
包含土耳其语和英语的警告和提示信息。
额外依赖(Laravel 6.x 及以上版本)
- SimpleXML PHP 扩展
安装(Laravel 9.x)
-
首先,将以下值添加到您的
composer.json
文件中的require
部分:"ardakilic/mutlucell": "~6"
或者,您也可以使用以下命令添加包:
composer require ardakilic/mutlucell:~6
-
之后,如果您手动更新了
composer.json
文件,请使用composer update
命令将代码包含到项目中。 -
现在,打开
config/app.php
文件,在providers
数组中添加以下内容Ardakilic\Mutlucell\MutlucellServiceProvider::class,
(Laravel 5.5 及以上版本无需此步骤)
-
现在,在同一个文件中,在
aliases
数组中添加以下内容:'Mutlucell' => Ardakilic\Mutlucell\Facades\Mutlucell::class,
(Laravel 5.5 及以上版本无需此步骤)
-
现在,将配置文件分享到您的环境。为此,请运行以下命令:
php artisan vendor:publish
-
将
config/mutlucell.php
文件分享。在这里,填写为 Mutlucell 分配的用户名、密码和 sender_id (originator),以及其他设置。
此外,在环境文件中填写 MUTLUCELL_USERNAME
、MUTLUCELL_PASSWORD
和 MUTLUCELL_DEFAULT_SENDER
值,以填充配置文件。
有关 Laravel 8.x 版本的使用信息,请参阅 相关分支的 README.md 文件。
有关 Laravel 7.x 版本的使用信息,请参阅 相关分支的 README.md 文件。
有关 Laravel 6.x 版本的使用信息,请参阅 相关分支的 README.md 文件。
有关 Laravel 5.x 版本的使用信息,请参阅 相关分支的 README.md 文件。
有关 Laravel 4.x 版本的使用信息,请参阅 相关分支的 README.md 文件。
使用
向某人发送即时短信
$send = Mutlucell::send('05312345678', 'Merhaba'); var_dump(Mutlucell::parseOutput($send));
短信已发送吗?
$send = Mutlucell::send('05312345678', 'Merhaba'); if(Mutlucell::getStatus($send)) { echo 'SMS başarı ile gönderildi!'; } else { echo 'SMS gönderilemedi'; }
Mutlucell SMS ID
为了跟踪发送的消息状态(是否已到达收件人),您需要 SMS ID 值。
以下是如何获取 SMS ID 并使用它进行查询的示例。
$send = Mutlucell::send('05312345678', 'Merhaba'); if(Mutlucell::getStatus($send)) { $messageId = Mutlucell::getMessageId($send); echo 'SMS başarı ile gönderildi! SMS ID: '. $messageId; } else { echo 'SMS gönderilemedi'; }
向多人同时发送相同短信
$kisiler = ['00905312345678', '+905351114478', '05369998874', '5315558896']; $send = Mutlucell::sendBulk($kisiler, 'Merhaba'); var_dump(Mutlucell::parseOutput($send));
或者
$send = Mutlucell::sendBulk('00905312345678, +905351114478, 05369998874, 5315558896', 'Merhaba'); Mutlucell::parseOutput($send);
向多人同时发送不同短信
$kisiMesajlar = [ ['05315558964', 'Merhaba1'], ['+905415589632', 'Merhaba2'], ['00905369998874', 'Merhaba3'] ]; $send = Mutlucell::sendMulti($kisiMesajlar); var_dump(Mutlucell::parseOutput($send));
或者
$kisiMesajlar = [ ['05315558964' => 'Merhaba1'], ['+905415589632' => 'Merhaba2'], ['00905369998874' => 'Merhaba3'] ]; $send = Mutlucell::sendMulti2($kisiMesajlar); var_dump(Mutlucell::parseOutput($send));
查询发送短信的状态
>>> \Mutlucell::getMessageReport('1234567890'); => [ [ "number" => "905321234567", "result" => "3", "result_text" => "Başarılı", ], ]
将一个或多个用户添加到黑名单
$sil = Mutlucell::addBlacklist('00905312345678'); var_dump(Mutlucell::parseOutput($sil));
或者
$sil = Mutlucell::addBlacklist('00905312345678, +905351114478, 05369998874, 5315558896'); var_dump(Mutlucell::parseOutput($sil));
或者
$kisiler = ['00905312345678', '+905351114478', '05369998874', '5315558896']; $sil = Mutlucell::addBlacklist($kisiler); var_dump(Mutlucell::parseOutput($sil));
从黑名单中移除一个或多个用户
$sil = Mutlucell::deleteBlackList('00905312345678'); var_dump(Mutlucell::parseOutput($sil));
或者
$sil = Mutlucell::deleteBlackList('00905312345678, +905351114478, 05369998874, 5315558896'); var_dump(Mutlucell::parseOutput($sil));
或者
$kisiler = ['00905312345678', '+905351114478', '05369998874', '5315558896']; $sil = Mutlucell::deleteBlackList($kisiler); var_dump(Mutlucell::parseOutput($sil));
如果您想从黑名单中移除所有用户,则参数应为空
$sil = Mutlucell::deleteBlackList(); var_dump(Mutlucell::parseOutput($sil));
使用不同的配置文件发送短信
$gonder = Mutlucell::setConfig(config('app.baskaConfig'))->send('05312345678', 'Merhaba');
甚至
$sms = Mutlucell::setConfig([ 'auth' => [ 'username' => 'baskauser', 'password' => 'baskaparola', ], 'default_sender' => 'baskaoriginator', ]); $sms->send('05312345678', 'Merhaba');
剩余账户查询
var_dump(Mutlucell::checkBalance());
列出发起者
var_dump(Mutlucell::listOriginators());
在未来的日期发送短信
Mutlucell::send('05312223665', 'Geç gidecek mesaj', '2099-06-30 15:00'); //saniye yok, dikkat!
使用不同的发起者(发送者ID)发送短信
Mutlucell::send('05312223665', 'merhaba', '', 'diğerOriginator');
待办事项
- 获取被列入黑名单的用户列表的方法
- ?
许可证
本软件包采用MIT许可证授权。
支持
如果这个项目对您有帮助,您可以向我捐款加密货币。以下是我的钱包地址:
BTC: 1QFHeSrhWWVhmneDBkArKvpmPohRjpf7p6
ETH / ERC20令牌: 0x3C2b0AC49257300DaB96dF8b49d254Bb696B3458
NEO / Nep5令牌: AYbHEah5Y4J6BV8Y9wkWJY7cCyHQameaHc