PHPackages                             tonci14/laravel-eurosms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. tonci14/laravel-eurosms

ActivePackage[HTTP &amp; Networking](/categories/http)

tonci14/laravel-eurosms
=======================

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

v2.05(10mo ago)13.6kmitPHPPHP ^7.4|^8

Since Oct 20Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/tonci14/laravel-eurosms)[ Packagist](https://packagist.org/packages/tonci14/laravel-eurosms)[ RSS](/packages/tonci14-laravel-eurosms/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (6)Versions (11)Used By (0)

Laravel EuroSMS 📱
=================

[](#laravel-eurosms-)

Laravel balíček na odosielanie SMS správ cez [EuroSMS](https://www.eurosms.com) 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
------------

[](#-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
---------------

[](#️-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

[](#-inštalácia-1)

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

php artisan migrate
```

---

🚀 Použitie
----------

[](#-použitie)

### 🔹 Odoslanie správy synchronne

[](#-odoslanie-správy-synchronne)

```
use EuroSms;

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

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

[](#-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
-----------------

[](#-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

[](#-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`
-----------------------------

[](#️-databáza-euro_sms_queue)

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

StĺpecPopis`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
------------

[](#-testovanie)

Spusť testy:

```
php artisan test
```

Testuje sa:

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

---

📚 Roadmap
---------

[](#-roadmap)

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

---

👤 Autor
-------

[](#-autor)

Vytvoril: [Tonci14](https://github.com/tonci14)

---

🪪 Licencia
----------

[](#-licencia)

MIT

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance54

Moderate activity, may be stable

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~110 days

Recently: every ~3 days

Total

10

Last Release

318d ago

Major Versions

v1.1.0 → v2.012025-06-21

### Community

Maintainers

![](https://www.gravatar.com/avatar/8181ec2504ece1c07ce89eaf0096bb799e38445199464d7cd5bc2e3ebd21cc60?d=identicon)[tonci14](/maintainers/tonci14)

---

Top Contributors

[![tonci14](https://avatars.githubusercontent.com/u/33051145?v=4)](https://github.com/tonci14 "tonci14 (2 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/tonci14-laravel-eurosms/health.svg)

```
[![Health](https://phpackages.com/badges/tonci14-laravel-eurosms/health.svg)](https://phpackages.com/packages/tonci14-laravel-eurosms)
```

###  Alternatives

[namu/wirechat

A Laravel Livewire messaging app for teams with private chats and group conversations.

54324.5k](/packages/namu-wirechat)[georgeboot/laravel-echo-api-gateway

Use Laravel Echo with API Gateway Websockets

10435.5k](/packages/georgeboot-laravel-echo-api-gateway)[muhammadhuzaifa/telescope-guzzle-watcher

Telescope Guzzle Watcher provide a custom watcher for intercepting http requests made via guzzlehttp/guzzle php library. The package uses the on\_stats request option for extracting the request/response data. The watcher intercept and log the request into the Laravel Telescope HTTP Client Watcher.

98239.8k1](/packages/muhammadhuzaifa-telescope-guzzle-watcher)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)[behamin/service-proxy

for proxy or sending requests to other services with useful utilities

102.2k](/packages/behamin-service-proxy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
