SMS4Jawaly for Lumen

مكتبة لإرسال الرسائل النصية القصيرة عبر خدمة SMS4Jawaly في إطار عمل Lumen.

المتطلبات

• PHP: ^7.0|^8.0
• guzzlehttp/guzzle: ^6.0|^7.0
• illuminate/support: ^7.0|^8.0|^9.0|^10.0

التثبيت

يمكنك تثبيت المكتبة باستخدام Composer:

composer require sms4jawaly/lumen

الإعداد

1. قم بإضافة مزود الخدمة في ملف bootstrap/app.php:

$app->register(Sms4jawaly\Lumen\Sms4jawalyServiceProvider::class);

2. قم بإضافة المتغيرات البيئية التالية في ملف .env:

SMS4JAWALY_USERNAME=your_username
SMS4JAWALY_PASSWORD=your_password

الاستخدام

الإصدار الكامل (Full Version)

use Sms4jawaly\Lumen\Gateway;

// إنشاء كائن جديد
$sms = new Gateway();

// إرسال رسالة
$response = $sms->sendSMS([
    'messages' => [
        [
            'text' => 'مرحباً بك بفورجوالي!',
            'numbers' => ['966500000000'],
            'sender' => '4jawaly'
        ]
    ]
]);

// الحصول على الرصيد
$balance = $sms->getBalance();

// الحصول على أسماء المرسلين
$senders = $sms->getSenderNames();

الإصدار المبسط (Lite Version)

use Sms4jawaly\Lumen\Gateway;

// إنشاء كائن جديد
$sms = new Gateway();

// إرسال رسالة بالطريقة المبسطة
$response = $sms->sendLite(
    'مرحباً بك!',                // نص الرسالة
    ['966500000000'],           // أرقام المستلمين
    '4jawaly'                   // اسم المرسل
);

// مثال على شكل الاستجابة
[
    'success' => true,          // نجاح العملية
    'total_success' => 1,       // عدد الرسائل الناجحة
    'total_failed' => 0,        // عدد الرسائل الفاشلة
    'job_ids' => ['123456'],    // معرفات المهام
    'errors' => []              // أي أخطاء إن وجدت
]

المساهمة

نرحب بمساهماتكم! يرجى إرسال pull request إذا كان لديكم أي تحسينات أو إصلاحات.

الترخيص

هذه المكتبة مرخصة تحت MIT License.