tonci14/laravel-eurosms

Simple service to send SMS via https://www.eurosms.com

v2.03 2025-06-21 10:18 UTC

Requires

• php: ^7.4|^8
• ext-json: *
• ext-mbstring: *
• giggsey/libphonenumber-for-php: ^9.0@dev
• guzzlehttp/guzzle: >=7.4
• laravel/framework: >=v7

Requires (Dev)

• friendsofphp/php-cs-fixer: >=3.5
• phpstan/phpstan: >=1.4
• phpunit/phpunit: >=9.5

mit

• Anton Adamec

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('[phone]', 'Ahoj, toto je testovacia správa.');

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

EuroSms::sendAsync(
    '[phone]',
    '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. [phone])
• Skontrolované, či je z povolenej krajiny (napr. SK, CZ, AT)

❌ Chybové situácie

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

EuroSms::send('[phone]', 'UK test');
// ➜ Phone number region 'GB' is not allowed

🗂️ Databáza: euro_sms_queue

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

Stĺpec	Popis
id	Primárny kľúč
user_id	Voliteľný ID používateľa
phone	Telefónne číslo
message	Obsah správy
status	sent, failed, pending
error	Chyba (ak nastala)
sent_at	Čas odoslania správy
created_at, updated_at	Laravel timestamps

🧪 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