ardakilic/mutlucell
Laravel Mutlucell SMS
Bu paket sayesinde Laravel kullanan projelerinizde Mutlucell altyapısını kullanarak tekli veya çoklu sms gönderebilir, bakiye ve originator ID sorgulayabilirsiniz.
Paket Laravel 4 ve üzerindeki tüm sürümleri destekler.
Uyarı, hata ve bilgilendirme için Türkçe ve de İngilizce dillerinde uyarı ve bilgi mesajlarını barındırır.
Ekstra Bağımlılıklar (Laravel 6.x sürümü ve üstü için)
- SimpleXML PHP Eklentisi
Kurulum
-
Öncelikle
composer.jsonpaketinizecomposer require ardakilic/mutlucellkomutu ile de paketi ekleyin. -
Ardından eğer
composer.jsondosyasını elinizle güncellediyseniz kodları projenize dahil etmek için Composer paketlerinizi güncellemelisiniz.composer installkomutu ile bunu yapabilirsiniz. -
(Sadece Laravel 5.5'ten daha eski sürümler için) Şimdi de
config/app.phpdosyasını açın,providersdizisi içine en alta şunu girin:Ardakilic\Mutlucell\MutlucellServiceProvider::class, -
(Sadece Laravel 5.5'ten daha eski sürümler için) Yine aynı dosyadaki
aliasesdizisi altına şu değeri girin:'Mutlucell' => Ardakilic\Mutlucell\Facades\Mutlucell::class, -
Şimdi de environment'ınıza konfigürasyon dosyasını paylaşmalısınız. Bunun için aşağıdaki komutu çalıştırın:
php artisan vendor:publish -
config/mutlucell.phpdosyası paylaşılacak. Burada Mutlucell için size atanan kullanıcı adı, parola ve sender_id (originator) değerlerini, ve de diğer ayarları doldurmalısınız.
Ayrıca environment dosyanıza MUTLUCELL_USERNAME, MUTLUCELL_PASSWORD ve MUTLUCELL_DEFAULT_SENDER değerlerini de doldurarak config dosyanızı besleyebilirsiniz.
Kullanım
Yükseltme (v2 / Breaking change)
Metotlar artık PHP 8 isimli argümanlarla çağrılmalıdır. Parametre adları değişti:
$senderID->sender:$receiversMessage->messages:(sendMulti2sendMultioldu; liste-içi-liste formatı kalktı, sadecenumara => mesajeşlemesi)sendBulk(recipients:)ve kara liste metotları artık sadece dizi kabul eder (phoneNumbers:)sendBulk(recipients: [])boş diziyle istek atmadan102döner (send()ile tutarlı)getMessageReporthata biçimi değişti:$report[0]yerine$report['error'](error_code/error_message)- Config ve
confirmhataları artıkInvalidArgumentException(\Exceptionyerine) - Tüm public metotlara dönüş tipi eklendi (
send(): string|int,checkBalance(): int, …) - Yeni sabitler:
Mutlucell::STATUS_SUCCESS/Mutlucell::STATUS_FAILED(getStatusdönüşüyle===ile karşılaştırın; facade üzerinden değil sınıf üzerinden erişilir) deleteBlackList->deleteBlacklist; numarasız çağrı tüm listeyi sildiği için artıkconfirm: trueister (deleteBlacklist(confirm: true)), aksi haldeInvalidArgumentExceptionatar$receiver->receiver:,$recipients->recipients:(artık sadece dizi kabul eder),$message->message:,$date->date:,$phoneNumbers->phoneNumbers:,$messageId->messageId:(anlamları değişmedi, sadece isimli çağrıda bu adları kullanın)
Not: sendMulti artık boş olmayan bir sender: değerini dikkate alır (önceden göz ardı edilip originator varsayılan olarak kalırdı).
// Eski
Mutlucell::send('05312345678', 'Merhaba');
// Yeni
Mutlucell::send(receiver: '05312345678', message: 'Merhaba');
Birine o anda tekil SMS göndermek için:
$send = Mutlucell::send(receiver: '05312345678', message: 'Merhaba');
var_dump(Mutlucell::parseOutput(output: $send));
SMS gönderildi mi ?
$send = Mutlucell::send(receiver: '05312345678', message: 'Merhaba');
if(Mutlucell::getStatus(output: $send)) {
echo 'SMS başarı ile gönderildi!';
} else {
echo 'SMS gönderilemedi';
}
Durumu sabitlerle karşılaştırmak için (facade sabitleri aktarmaz, sınıfı ayrı bir adla içeri alın):
use Ardakilic\Mutlucell\Mutlucell as SmsStatus;
if (Mutlucell::getStatus(output: $send) === SmsStatus::STATUS_SUCCESS) {
echo 'SMS başarı ile gönderildi!';
}
Mutlucell SMS ID
Gönderilen mesajın durumunu (karşı tarafa ulaşıp ulaşmadığı) takip edebilmeniz için SMS ID değerine ihtiyacınız var.
Aşağıdaki şekilde, SMS ID edinip, daha sonra bununla sorgulama yapabilirsiniz.
$send = Mutlucell::send(receiver: '05312345678', message: 'Merhaba');
if(Mutlucell::getStatus(output: $send)) {
$messageId = Mutlucell::getMessageId(output: $send);
echo 'SMS başarı ile gönderildi! SMS ID: '. $messageId;
} else {
echo 'SMS gönderilemedi';
}
Birden fazla kişiye aynı anda aynı SMS'i göndermek için:
$kisiler = ['00905312345678', '+905351114478', '05369998874', '5315558896'];
$send = Mutlucell::sendBulk(recipients: $kisiler, message: 'Merhaba');
var_dump(Mutlucell::parseOutput(output: $send));
Birden fazla kişiye aynı anda farklı SMS'ler göndermek için:
$kisiMesajlar = [
'05315558964' => 'Merhaba1',
'+905415589632' => 'Merhaba2',
'00905369998874' => 'Merhaba3'
];
$send = Mutlucell::sendMulti(messages: $kisiMesajlar);
var_dump(Mutlucell::parseOutput(output: $send));
Gönderilen mesajın durumunu sorgulamak için:
>>> \Mutlucell::getMessageReport(messageId: '1234567890');
=> [
'success' => true,
'numbers' => [
'905321234567' => [
'success' => true,
'number' => '905321234567',
'result' => '3',
'result_text' => 'Başarılı',
],
],
]
# Hatalı ID'de:
=> [
'success' => false,
'error' => ['error_code' => 20, 'error_message' => '...'],
]
Bir veya birden Fazla Kullanıcıyı Kara Listeye Eklemek İçin
$kisiler = ['00905312345678', '+905351114478', '05369998874', '5315558896'];
$sil = Mutlucell::addBlacklist(phoneNumbers: $kisiler);
var_dump(Mutlucell::parseOutput(output: $sil));
Bir veya Birden Fazla Kullanıcıyı Kara Listeden Çıkartmak İçin
$kisiler = ['00905312345678', '+905351114478', '05369998874', '5315558896'];
$sil = Mutlucell::deleteBlacklist(phoneNumbers: $kisiler);
var_dump(Mutlucell::parseOutput(output: $sil));
Eğer tüm kullanıcıları kara listeden çıkartmak istiyorsanız confirm: true ile çağırın (parametresiz çağrı hata verir):
$sil = Mutlucell::deleteBlacklist(confirm: true);
var_dump(Mutlucell::parseOutput(output: $sil));
Farklı bir ayar dosyası ile SMS göndermek için
$gonder = Mutlucell::setConfig(config('app.baskaConfig'))
->send(receiver: '05312345678', message: 'Merhaba');
Hatta
$sms = Mutlucell::setConfig([
'auth' => [
'username' => 'baskauser',
'password' => 'baskaparola',
],
'default_sender' => 'baskaoriginator',
]);
$sms->send(receiver: '05312345678', message: 'Merhaba');
Kalan Kontör Sorgulaması için:
var_dump(Mutlucell::checkBalance());
Originatörleri listelemek için:
var_dump(Mutlucell::listOriginators());
Gelecek bir tarihe SMS yollamak için:
Mutlucell::send(receiver: '05312223665', message: 'Geç gidecek mesaj', date: '2099-06-30 15:00'); // Saniye yok, dikkat!
Farklı bir Originatör (Sender ID) kullanarak SMS yollamak için:
Mutlucell::send(receiver: '05312223665', message: 'merhaba', sender: 'diğerOriginator');
Yapılacaklar
- Kara Listeye giren kullanıcı listesini alma metodu
- ?
Testler
make test
Testler Docker içinde çalışır (yerel PHP gerekmez), tüm HTTP istekleri
mock'lanır (Guzzle MockHandler), gerçek Mutlucell API'ına istek atılmaz.
Alternatif: docker compose run --rm tests.
Lisans
Bu yazılım paketi MIT lisansı ile lisanslanmıştır.
Destek
Bu proje eğer işinize yaradıysa kripto paralarla bana bağışta bulunabilirsiniz. Aşağıda cüzdan adreslerimi bulabilirsiniz:
BTC: 1QFHeSrhWWVhmneDBkArKvpmPohRjpf7p6
ETH / ERC20 Token'ları: 0x3C2b0AC49257300DaB96dF8b49d254Bb696B3458
Related Packages
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| 13.0.0 | ^8.3 | 13.* | MIT | |
| 9.0.0 | ^7.3| | 12.* | MIT | |
| 8.0.0 | ^7.3| | 11.* | MIT | |
| 7.0.0 | ^7.3| | 10.* | MIT | |
| 6.0.0 | ^7.3| | 9.* | MIT | |
| 5.1.1 | ^7.3| | 8.* | MIT | |
| 5.1.0 | ^7.3 | 8.* | MIT | |
| 5.0.0 | ^7.3 | 8.* | MIT | |
| 4.0.2 | ^7.3| | 7.* | MIT | |
| 4.0.1 | ^7.3 | 7.* | MIT | |
| 4.0.0 | ^7.3 | 7.* | MIT | |
| 3.0.2 | >=7.2.0 | 6.* | MIT | |
| 3.0.1 | >=7.2.0 | 6.* | MIT | |
| 3.0.0 | >=7.2.0 | 6.* | MIT | |
| 2.5.2 | >=5.5.9 | 5.* | MIT | |
| 2.5.1 | >=5.5.9 | 5.* | MIT | |
| 2.5.0 | >=5.5.9 | 5.* | MIT | |
| 2.4.0 | >=5.5.9 | 5.* | MIT | |
| 2.3.1 | >=5.5.9 | 5.* | MIT | |
| 2.3.0 | >=5.5.9 | 5.* | MIT | |
| 2.2.0 | >=5.5.9 | 5.* | MIT | |
| 2.1.0 | >=5.5.9 | 5.* | MIT | |
| 2.0.1 | >=5.3.0 | 5.* | MIT | |
| 2.0.0 | >=5.3.0 | 5.* | MIT | |
| 1.4.0 | >=5.3.0 | 4.* | MIT | |
| 1.3.2 | >=5.3.0 | 4.* | MIT | |
| 1.3.1 | >=5.3.0 | 4.* | MIT | |
| 1.3.0 | >=5.3.0 | 4.* | MIT | |
| 1.2.1 | >=5.3.0 | 4.* | MIT | |
| 1.2.0 | >=5.3.0 | 4.* | MIT |
Showing the latest 30 of 32. See every release on Packagist