Bundle-ul oficial Symfony pentru Calisero este publicat și gata de folosit în producție. Construit peste biblioteca PHP, aduce trimiterea de SMS-uri, verificarea prin OTP și rapoartele de livrare într-o aplicație Symfony prin uneltele pe care le folosești deja: configurare, autowiring, componenta Notifier, evenimente și consola.
Ce include
Configurare din variabile de mediu. Setezi cheia API, expeditorul implicit și webhook-ul sub cheia calisero, fiecare valoare din %env(...)%. Cu Symfony Flex, bundle-ul se înregistrează singur.
Client cu autowiring. Ceri SmsClientInterface în constructor și trimiți SMS-uri și coduri de verificare, citești mesaje și verifici contul. Serviciile bibliotecii PHP pentru mesaje, verificări, opt-out și conturi primesc și ele autowiring.
Transport Notifier. Trimiți prin TexterInterface și prin canalul sms al notificărilor cu DSN-ul calisero://, iar pe fiecare mesaj setezi opțiunile Calisero — scurtarea link-urilor, valabilitatea, programarea.
Webhook de livrare cu evenimente. Imporți rutele bundle-ului și fiecare raport de livrare devine un eveniment Symfony: trimis, livrat sau eșuat. Creditul scăzut are și el evenimentele lui. Un token opțional în adresa de callback respinge cererile care nu îl conțin.
Comenzi de consolă. Trimitere de test, starea unui mesaj, detaliile contului, trimiterea și verificarea unui cod, direct din bin/console.
Constrângeri de validare. PhoneE164 și SenderId verifică numerele de telefon și expeditorii în formulare și obiecte, cu mesaje traduse în română.
Cui îi este util
Dacă aplicația ta rulează pe Symfony și trimite coduri OTP, confirmări de comandă sau notificări de livrare, bundle-ul îți scutește stratul de integrare pe care altfel l-ai scrie manual: configurarea clientului, procesarea callback-urilor, evenimentele de status. Dacă vii de la pachetul Laravel, regăsești aceleași metode și parametri.
Cum începi
Bundle-ul se instalează prin Composer:
composer require calisero/symfony-sms
Suportă Symfony 6.4, 7 și 8 pe PHP 8.2 până la 8.5, iar fiecare combinație este testată. Codul sursă este public pe GitHub, cu exemple pentru fiecare funcționalitate, iar pagina de integrări listează versiunea curentă.
Biblioteca Node.js s-a lansat în aceeași zi. Urmează bibliotecile Go și Python.
