Türkiye'nin önde gelen SMS gönderim servislerinden biri olan Codec Mesajlaşma Platformu'nu artık Laravel web projelerinize kolay ve sıkıntısız bir şekilde entegre etmenize imkan sağlayan Laravel Codec Fast Sms paketini huzurlarınıza sunuyorum.

Gereksinimler

Laravel >= 5.3
PHP >= 5.6.4

Kurulum

Öncelikle hayrican/laravel-codec-fastsms paketini projenizin Composer bağımlılıklarına eklemeniz gerekmektedir. Bunun için aşağıdaki komutu projeniz içerisinde çalıştırın.

composer require hayrican/laravel-codec-fastsms

Service Provider (Laravel 5.5'ten Eski Versiyonlar)

Eğer Laravel 5.5 veya daha yeni bir versiyonunu kullanıyorsanız bu adımı atlayabilirsiniz.

Servis Provider kaydını config/app.php klasöründe yapınız.

'providers' => [
    ...,
    HayriCan\CodecFastSms\CodecFastSmsServiceProvider::class,
]

Konfigürasyon

Konfigürasyon dosyasını oluşturmak için vendor:publish komutunu çağırınız.

$ php artisan vendor:publish --provider="HayriCan\CodecFastSms\CodecFastSmsServiceProvider"

Codec API Erişim Bilgileri

Projenizde config/codecfastsms.php klasörünü görüntüleyip Codec API erişim bilgilerinizi buraya giriniz.

[
  'username'=> "CODEC_USERNAME",
  'password'=> "CODEC_PASSWORD",
  'sender'=> "CODEC_SENDER",
]

Rota Yapılandırması

Varsayılan router prefix'i api ve middleware api. Bu bölümde prefix ve middleware bölümlerini düzenleyebilirsiniz.

[
  'route_prefix'=> 'api',

  'middleware'=> ['api'],
]

SMS İsteğini Kaydet

Varsayılan record değeri false ve bunun anlamı sms istekleriniz veritabanına kaydedilmeyecek. Eğer sms isteklerinizi veritabanına kaydetmek istiyorsanız bu alanı true yapınız.

[
  'record'=> true
]

Değeri true olarak değiştirdikten sonra projeyi migrate etmeniz gerekiyor

$ php artisan migrate

Bu işlemden sonra sms_records_table tablosu veritabanınızda oluşturulacak.

Paketin Kullanımı

1.HTTP Request

Artık /codec-fastsms rotasına POST isteği yaparak sms gönderebilirsiniz

Örn1. Bir numaraya mesaj gönderime

Örn2. Birden fazla numaraya aynı mesajı gönderme

Örn3. Birden fazla numaraya farklı mesaj gönderme

2.Artisan Konsol

Örn1. Bir numaraya mesaj gönderime

$ php artisan fastsms:send --phone='5XXXXXXXXX' --messageContent='Message Text'

Örn2. Birden fazla numaraya aynı mesajı gönderme

$ php artisan fastsms:send --phone='5XXXXXXXXX~5YYYYYYYYY~5ZZZZZZZZZ' --messageContent='Message Text'

Örn3. Birden fazla numaraya farklı mesaj gönderme

$ php artisan fastsms:send --phone='5XXXXXXXXX~5YYYYYYYYY~5ZZZZZZZZZ' --messageContent='Message Text~Message Text2~Message Text3'

Detaylı dökümantasyona erişmek ve güncellemeler hakkında bilgi sahibi olmak için https://github.com/HayriCan/laravel-codec-fastsms sayfasını ziyaret etmeyi unutmayın.