README

Laravel balíček na odosielanie SMS správ cez EuroSMS API.

Podporuje:

• Synchronné aj asynchrónne odosielanie správ
• Logovanie odoslaných SMS do databázy
• Validáciu čísel vo formáte E.164 (s povolenými krajinami)
• Laravel queue (joby)
• Facade EuroSms::send(...) a EuroSms::sendAsync(...)

💡 Inštalácia

composer require tonci14/laravel-eurosms

Publikuj config a migrácie:

php artisan vendor:publish --provider="Tonci14\LaravelEuroSMS\LaravelEuroSMSServiceProvider" --tag=eurosms-config
php artisan migrate

⚙️ Konfigurácia

V .env súbore:

EURO_SMS_URL=https://as.eurosms.com/sms/Sender
EUROSMS_KEY= -- provided key --
EUROSMS_ID= -- privided ID --
SMS_SENDER_NAME= -- use custom name up to 10 letters --

V config/eurosms.php:

return [
    'url'            => env('EURO_SMS_URL', 'https://as.eurosms.com/sms/Sender'),
    'integrationKey' => env('EUROSMS_KEY', null),
    'integrationID'  => env('EUROSMS_ID', null),
    'senderName'     => env('SMS_SENDER_NAME', null),

    // Povolené krajiny podľa kódu ISO (2-písmenový) napr: 'SK', 'CZ', 'AT'
    'allowed_countries' => [],
];

🔹 Inštalácia

php artisan vendor:publish --tag=eurosms-migrations
php artisan vendor:publish --tag=eurosms-config

php artisan migrate

🚀 Použitie

🔹 Odoslanie správy synchronne

use EuroSms;

EuroSms::send('+421900123456', 'Ahoj, toto je testovacia správa.');

🔹 Odoslanie správy asynchrónne (cez queue)

EuroSms::sendAsync(
    '+421900123456',
    'Toto ide cez queue',
    locale: null,
    queue: 'messaging',
    userId: auth()->id()
);

Asynchrónna správa sa vloží do queue a uloží do tabuľky euro_sms_queue.

✅ Validácia čísel

Pred každým odoslaním je číslo:

• Validované pomocou knižnice giggsey/libphonenumber-for-php
• Uložené vo formáte E.164 (napr. +421900123456)
• Skontrolované, či je z povolenej krajiny (napr. SK, CZ, AT)

❌ Chybové situácie

EuroSms::send('0900123456', 'Test');
// ➜ Invalid phone number format

EuroSms::send('+441234567890', 'UK test');
// ➜ Phone number region 'GB' is not allowed

🗂️ Databáza: euro_sms_queue

Každá správa sa loguje do databázy:

🧪 Testovanie

Spusť testy:

php artisan test

Testuje sa:

• synchronné/asynchrónne odoslanie
• logovanie do databázy
• validácia čísel
• chybové stavy

📚 Roadmap

• Šablóny správ (viacjazyčné)
• Retry logika pre failed správy
• Webhook listener na spätné stavy
• Laravel Notification support

👤 Autor

Vytvoril: Tonci14

🪪 Licencia

MIT