New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel
8,116 45
Install
composer require ardakilic/mutlucell
Latest Version:13.0.0
PHP:^8.3
Laravel:13
Older releases:4 – 12
License:MIT
Last Updated:Nov 7, 2026
Links: GitHub  ·  Packagist
Maintainer: Ardakilic

Laravel Mutlucell SMS

Latest Stable Version Total Downloads Latest Unstable Version License

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.json paketinize composer require ardakilic/mutlucell komutu ile de paketi ekleyin.

  • Ardından eğer composer.json dosyasını elinizle güncellediyseniz kodları projenize dahil etmek için Composer paketlerinizi güncellemelisiniz. composer install komutu ile bunu yapabilirsiniz.

  • (Sadece Laravel 5.5'ten daha eski sürümler için) Şimdi de config/app.php dosyasını açın, providers dizisi 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 aliases dizisi 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.php dosyası 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: (sendMulti2 sendMulti oldu; liste-içi-liste formatı kalktı, sadece numara => mesaj eşlemesi)
  • sendBulk(recipients:) ve kara liste metotları artık sadece dizi kabul eder (phoneNumbers:)
  • sendBulk(recipients: []) boş diziyle istek atmadan 102 döner (send() ile tutarlı)
  • getMessageReport hata biçimi değişti: $report[0] yerine $report['error'] (error_code / error_message)
  • Config ve confirm hataları artık InvalidArgumentException (\Exception yerine)
  • Tüm public metotlara dönüş tipi eklendi (send(): string|int, checkBalance(): int, …)
  • Yeni sabitler: Mutlucell::STATUS_SUCCESS / Mutlucell::STATUS_FAILED (getStatus dö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ık confirm: true ister (deleteBlacklist(confirm: true)), aksi halde InvalidArgumentException atar
  • $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

sineld/sms

Türkiye Sms API for sending sms text messages.

27 9
itsaafrin/isms

A Laravel 4 SMS Api Package (isms.com.my)

5 4
kavenegar/laravel

laravel 4 and 5 kavenegar integration

389,208 86
melipayamak/laravel

Laravel Melipayamak Integration

33,910 25
erfanhemmati/kavenegar

laravel 4 and 5 kavenegar integration

2,736 0

Version History

Version Released PHP Laravel License
13.0.0 ^8.3 13.* MIT
9.0.0 ^7.3|^8.0 12.* MIT
8.0.0 ^7.3|^8.0 11.* MIT
7.0.0 ^7.3|^8.0 10.* MIT
6.0.0 ^7.3|^8.0 9.* MIT