serwersms/serwersmsbundle

Symfony 8.1 Bundle for communication with the API v2 SerwerSMS.pl

v2.0.1 2026-06-23 08:37 UTC

Requires

• php: >=8.4
• ext-curl: *
• ext-json: *
• lib-curl: *
• symfony/config: ^8.0
• symfony/framework-bundle: ^8.0

Requires (Dev)

• phpunit/phpunit: ^12.0
• symfony/test-pack: ^1.0

Apache-2.0

• SerwerSMS.pl

• symfony
• api
• sms
• serwersms

README

Klient PHP dla frameworka Symfony do komunikacji z API v2 SerwerSMS.pl

Zalecane jest, aby komunikacja przez HTTPS API odbywała się z loginów utworzonych specjalnie do połączenia przez API. Konto użytkownika API można utworzyć w Panelu Klienta → Ustawienia interfejsów → HTTP API → Użytkownicy API.

Wymagania

• PHP >= 8.4
• Symfony >= 8.1

Instalacja

Przez Composer:

composer require serwersms/serwersmsbundle

Lub ręcznie w composer.json:

{
    "require": {
        "serwersms/serwersmsbundle": "^2.0"
    }
}

Konfiguracja

Opcja 1 — autentykacja przez token

# config/packages/serwer_sms.yaml
serwer_sms:
    serwersms_token: '%env(SERWERSMS_TOKEN)%'

Opcja 2 — autentykacja przez username i password

# config/packages/serwer_sms.yaml
serwer_sms:
    serwersms_username: '%env(SERWERSMS_USERNAME)%'
    serwersms_password: '%env(SERWERSMS_PASSWORD)%'

Opcjonalne parametry dla obu opcji:

serwer_sms:
    # ...
    serwersms_api_url: 'https://api2.serwersms.pl'  # domyślnie
    serwersms_timeout: 30                            # domyślnie

Opcja 3 — rejestracja ręczna w services.yaml

Zamiast konfiguracji bundla, klasę można zarejestrować bezpośrednio jako serwis Symfony:

Z tokenem:

# config/services.yaml
services:
    serwer_sms:
        class: SerwerSMS\SerwerSMSBundle\SerwerSMSToken
        public: true
        arguments:
            - '%env(SERWERSMS_TOKEN)%'

    SerwerSMS\SerwerSMSBundle\SerwerSMSInterface: '@serwer_sms'

Z username i password:

# config/services.yaml
services:
    serwer_sms:
        class: SerwerSMS\SerwerSMSBundle\SerwerSMS
        public: true
        arguments:
            - '%env(SERWERSMS_USERNAME)%'
            - '%env(SERWERSMS_PASSWORD)%'

    SerwerSMS\SerwerSMSBundle\SerwerSMSInterface: '@serwer_sms'

Użycie w kontrolerze

namespace App\Controller;

use SerwerSMS\SerwerSMSBundle\SerwerSMSInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Routing\Attribute\Route;

class SmsController extends AbstractController
{
    public function __construct(private SerwerSMSInterface $serwerSms)
    {
    }

    #[Route('/send-sms')]
    public function sendSms(): JsonResponse
    {
        try {

            $result = $this->serwerSms->messages()->sendSms(
                [
                    '[phone]',
                    '[phone]'
                 ],
                'Test FULL message',
                'INFORMACJA',
                [
                    'test' => true,
                    'details' => true
                ]
            );

            return new JsonResponse($result);

        } catch (\Exception $e) {
            return new JsonResponse(['error' => $e->getMessage()], 500);
        }
    }
}

Przykłady

try {

    // SMS FULL
    $result = $this->serwerSms->messages()->sendSms(
        [
            '[phone]',
            '[phone]'
        ],
        'Test FULL message',
        'INFORMACJA',
        [
            'test' => true,
            'details' => true
        ]
    );

    // SMS ECO
    $result = $this->serwerSms->messages()->sendSms(
        [
            '[phone]',
            '[phone]'
        ],
        'Test ECO message',
        null,
        [
            'test' => true,
            'details' => true
        ]
    );

    // VOICE from text
    $result = $this->serwerSms->messages()->sendVoice(
        [
            '[phone]',
            '[phone]'
        ],
        [
            'text' => 'Test message',
            'test' => true,
            'details' => true
        ]
    );

    // MMS
    $list = $this->serwerSms->files()->index('mms');
    $result = $this->serwerSms->messages()->sendMms(
        [
            '[phone]',
            '[phone]'
        ],
        'MMS Title',
        [
            'test' => true,
            'file_id' => $list->items[0]->id,
            'details' => true
        ]
    );

    echo 'Skolejkowano: ' . $result->queued . '<br />';
    echo 'Niewysłano: ' . $result->unsent . '<br />';

    foreach ($result->items as $sms) {
        echo 'ID: ' . $sms->id . '<br />';
        echo 'NUMER: ' . $sms->phone . '<br />';
        echo 'STATUS: ' . $sms->status . '<br />';
        echo 'CZĘŚCI: ' . $sms->parts . '<br />';
        echo 'WIADOMOŚĆ: ' . $sms->text . '<br />';
    }

} catch (\Exception $e) {
    echo 'ERROR: ' . $e->getMessage();
}

Wysyłka spersonalizowanych SMS

try {

    $messages[] = [
        'phone' => '500600700',
        'text' => 'First message'
    ];
    $messages[] = [
        'phone' => '600700800',
        'text' => 'Second message'
    ];

    $result = $this->serwerSms->messages()->sendPersonalized(
        $messages,
        'INFORMACJA',
        [
            'test' => true,
            'details' => true
        ]
    );

    echo 'Skolejkowano: ' . $result->queued . '<br />';
    echo 'Niewysłano: ' . $result->unsent . '<br />';

    foreach ($result->items as $sms) {
        echo 'ID: ' . $sms->id . '<br />';
        echo 'NUMER: ' . $sms->phone . '<br />';
        echo 'STATUS: ' . $sms->status . '<br />';
        echo 'CZĘŚCI: ' . $sms->parts . '<br />';
        echo 'WIADOMOŚĆ: ' . $sms->text . '<br />';
    }

} catch (\Exception $e) {
    echo 'ERROR: ' . $e->getMessage();
}

Pobieranie raportów doręczeń

try {

    $result = $this->serwerSms->messages()->reports(['id' => ['aca3944055']]);

    foreach ($result->items as $sms) {
        echo 'ID: ' . $sms->id . '<br />';
        echo 'NUMER: ' . $sms->phone . '<br />';
        echo 'STATUS: ' . $sms->status . '<br />';
        echo 'SKOLEJKOWANO: '. $sms->queued . '<br />';
        echo 'WYSŁANO: ' . $sms->sent . '<br />';
        echo 'DORĘCZONO: ' . $sms->delivered . '<br />';
        echo 'NADAWCA: ' . $sms->sender . '<br />';
        echo 'TYP: ' . $sms->type . '<br />';
        echo 'WIADOMOŚĆ: ' . $sms->text . '<br />';
    }

} catch (\Exception $e) {
    echo 'ERROR: ' . $e->getMessage();
}

Pobieranie wiadomości przychodzących

try {

    $result = $this->serwerSms->messages()->received('ndi');

    foreach ($result->items as $sms) {
        echo 'ID: ' . $sms->id . '<br />';
        echo 'TYP: ' . $sms->type . '<br />';
        echo 'NUMER: ' . $sms->phone . '<br />';
        echo 'DATA: ' . $sms->received . '<br />';
        echo 'CZARNA LISTA: ' . $sms->blacklist . '<br />';
        echo 'WIADOMOŚĆ: ' . $sms->text . '<br />';
    }

} catch (\Exception $e) {
    echo 'ERROR: ' . $e->getMessage();
}

Dokumentacja API

http://dev.serwersms.pl

Konsola API: http://apiconsole.serwersms.pl/