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 & Networking](/categories/http)
4. /
5. tonci14/laravel-eurosms

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

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

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

v2.05(12mo ago)13.7kmitPHPPHP ^7.4|^8

Since Oct 20Pushed 12mo 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 yesterday

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

36

—

LowBetter than 79% of packages

Maintenance50

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

364d ago

Major Versions

v1.1.0 → v2.012025-06-21

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/33051145?v=4)[Anton Adamec](/maintainers/tonci14)[@tonci14](https://github.com/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

[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.7M223](/packages/backpack-crud)[statamic/cms

The Statamic CMS Core Package

4.8k3.6M991](/packages/statamic-cms)[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[api-platform/laravel

API Platform support for Laravel

58171.6k14](/packages/api-platform-laravel)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1235.9k20](/packages/fleetbase-core-api)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

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