tmoh/orange-sms-package

Laravel package for Orange SMS API integration

v1.0.1 2025-07-17 05:54 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.0
• laravel/framework: ^10.0|^11.0|^12.0

Requires (Dev)

• mockery/mockery: ^1.6
• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0

MIT

• tmoh

• api
• sms
• laravel
• orange

README

Package Laravel pour l'intégration de l'API SMS d'Orange. Envoyez des SMS, consultez le solde et les statistiques d'usage.

Fonctionnalités

• Envoi de SMS avec formatage automatique
• Consultation du solde SMS
• Statistiques d'usage détaillées
• Historique des achats
• Authentification OAuth automatique
• Facade Laravel simple d'utilisation

Installation

composer require tmoh/orange-sms-package

Publiez la configuration :

php artisan vendor:publish --tag=orange-sms-config

Configuration

Ajoutez dans votre .env :

ORANGE_SMS_BASE_URL=https://api.orange.com
ORANGE_SMS_BASIC_TOKEN=your_basic_token_here
ORANGE_SMS_DEFAULT_SENDER_ADDRESS=[phone]
ORANGE_SMS_DEFAULT_SENDER_NAME="SMS 987519"
ORANGE_SMS_TIMEOUT=30

Utilisation

Via la Facade

use Tmoh\OrangeSmsPackage\Facades\OrangeSms;

// Envoyer un SMS
$response = OrangeSms::sendSms(
    '[phone]',
    'Votre code de vérification est 123456',
    'MyApp'
);

if ($response->success) {
    echo "SMS envoyé avec succès!";
} else {
    echo "Erreur: " . $response->error->text ?? 'Erreur inconnue';
}

// Consulter le solde
$balance = OrangeSms::viewSmsBalance();

// Consulter les statistiques
$usage = OrangeSms::viewSmsUsage();

// Historique des achats
$history = OrangeSms::viewPurchaseHistory();

Via l'Injection de Dépendance

use Tmoh\OrangeSmsPackage\Contracts\OrangeSmsServiceInterface;

class SmsController extends Controller
{
    public function __construct(
        private OrangeSmsServiceInterface $smsService
    ) {}

    public function sendSms(Request $request)
    {
        $response = $this->smsService->sendSms(
            $request->input('phone'),
            $request->input('message'),
            $request->input('sender_name')
        );

        return response()->json($response);
    }
}

Tests

composer test

Licence

MIT License

Support

• Email : [e-mail]
• Issues : GitHub Issues

Si ce package vous a aidé, n'hésitez pas à le star sur GitHub !