ardakilic / mutlucell
Mutlucell SMS API wrapper for sending sms text messages for Laravel
Requires
- php: ^8.3
- ext-simplexml: *
- guzzlehttp/guzzle: ^6.5.6|^7.8.2
- illuminate/support: 13.*
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 00:11:01 UTC
README
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