README

本包允许在 Laravel 项目中使用 Mutlucell 基础设施发送单条或多条短信，并查询余额和发送者 ID。

本包支持 Laravel 4 及以上所有版本。

包含土耳其语和英语的警告和信息消息。

额外依赖（Laravel 6.x 及以上版本）

• SimpleXML PHP 扩展

安装

• 首先，使用以下命令将包添加到您的 composer.json 文件中：composer require ardakilic/mutlucell。

• 如果手动更新了 composer.json 文件，请使用以下命令更新项目中的包：composer install。

• （仅适用于 Laravel 5.5 及以下版本） 现在打开 config/app.php 文件，在 providers 数组中添加以下内容

  Ardakilic\Mutlucell\MutlucellServiceProvider::class,

• （仅适用于 Laravel 5.5 及以下版本） 同样在文件中的 aliases 数组中添加以下值

  'Mutlucell' => Ardakilic\Mutlucell\Facades\Mutlucell::class,

• 现在将配置文件分享到您的环境。为此，运行以下命令

  php artisan vendor:publish

• 将分享 config/mutlucell.php 文件。在这里，您需要填写为 Mutlucell 分配的用户名、密码和 sender_id（发送者 ID）以及其他设置。

此外，在环境文件中填写 MUTLUCELL_USERNAME、MUTLUCELL_PASSWORD 和 MUTLUCELL_DEFAULT_SENDER 值，以提供对配置文件的支持。

使用

向某个人发送当前的单条短信

$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 并使用它进行查询。

以下是如何获取 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!

使用不同的 Originator（发送者 ID）发送短信

Mutlucell::send('05312223665', 'merhaba', '', 'diğerOriginator');

待办事项

• 获取进入黑名单的用户列表的方法
• ?

许可证

本软件包采用 MIT 许可证授权。

支持

如果本项目对您有帮助，您可以以加密货币的形式进行捐赠。以下是我的钱包地址

BTC: 1QFHeSrhWWVhmneDBkArKvpmPohRjpf7p6

ETH / ERC20 代币: 0x3C2b0AC49257300DaB96dF8b49d254Bb696B3458