ارسال پیامک در پروژه‌های CodeIgniter 4 با استفاده از پکیج SMSRocket

در دنیای توسعه وب، ارسال پیامک برای اطلاع‌رسانی، تایید ثبت‌نام، یا ارائه خدمات به کاربران به یکی از نیازهای اساسی تبدیل شده است. با توجه به اینکه بسیاری از پروژه‌ها از فریم‌ورک CodeIgniter4 برای توسعه استفاده می‌کنند، داشتن یک ابزار ساده و انعطاف‌پذیر برای ارسال پیامک می‌تواند کار را بسیار آسان‌تر کند. در این مقاله، من به معرفی پکیج SMSRocket خواهم پرداخت که مخصوص CodeIgniter 4 طراحی شده است و امکانات زیادی برای ارسال پیامک به کاربران شما را فراهم می‌آورد.

چرا باید از SMSRocket استفاده کنیم؟

در پروژه‌های مختلف، نیاز به ارسال پیامک از سرویس‌های مختلف وجود دارد. اما هر یک از این سرویس‌ها ویژگی‌ها و API‌های خاص خود را دارند. SMSRocket یک پکیج انعطاف‌پذیر و ساده است که با پشتیبانی از چندین درایور برای سرویس‌های مختلف ارسال پیامک(فراز اس ام اس، آموت پیامک، ایده پردازان،Twilio و ...)، این امکان را به شما می‌دهد که به راحتی با یک کد ساده پیامک ارسال کنید.

ویژگی‌های کلیدی پکیج SMSRocket:

1. پشتیبانی از چندین درایور:
   این پکیج از درایورهای مختلفی مانند Twilioو Farazsms، AmootSMS،ایده پردازان و... سایر سرویس‌های پیامکی معروف پشتیبانی می‌کند. بنابراین، شما می‌توانید به راحتی از هر سرویس دلخواه برای ارسال پیامک استفاده کنید.
2. ارسال پیامک‌های الگو دار (Patterned SMS):
   اگر نیاز دارید تا پیامک‌های خاص و سفارشی را ارسال کنید، این پکیج به شما اجازه می‌دهد که پیامک‌های خود را با استفاده از الگوهای پیش‌تعریف شده ارسال کنید. این ویژگی برای کاربردهایی مانند ارسال کد تایید، فاکتورها و غیره بسیار مناسب است.
3. پیکربندی آسان:
   پکیج SMSRocket به راحتی قابل پیکربندی است. شما می‌توانید داده‌های مورد نیاز برای هر سرویس پیامکی را از طریق فایل‌های پیکربندی ساده وارد کنید. همچنین، پکیج از فایل env. برای تنظیمات پویا نیز پشتیبانی می‌کند.
4. حمایت از ارسال پیامک به چندین گیرنده:
   یکی دیگر از ویژگی‌های جذاب SMSRocket این است که می‌توانید پیامک‌ها را به طور همزمان برای چندین گیرنده ارسال کنید. این ویژگی در مواقعی که نیاز دارید پیام‌های گروهی ارسال کنید، بسیار مفید است.
5. قابلیت کشینگ (Caching):
   پکیج از کشینگ برای ذخیره نتایج API پشتیبانی می‌کند تا بار سرور کاهش یابد و عملکرد بهبود پیدا کند.
6. تاریخچه داده ها (Data History):
   پکیج SMSRocket قابلیت نگهداری تاریخچه کامل تراکنش‌های پیامک را در دیتابیس فراهم می‌کند. این ویژگی به شما این امکان را می‌دهد که برای تحلیل‌ها و ارزیابی‌های آینده، تمام پیامک‌های ارسالی و دریافتی را ذخیره و مرور کنید.
7. مدیریت داده‌های حساس(Sensitive Data Handling):
   این ویژگی به شما کمک می‌کند تا اطلاعات حساس مانند شماره تلفن‌ها یا محتوای پیام‌ها را پیش از ذخیره در دیتابیس به‌صورت امن و بدون نمایش اطلاعات حساس ذخیره کنید. این کار از طریق obfuscation انجام می‌شود، که باعث می‌شود داده‌ها برای دسترسی‌های غیرمجاز غیرقابل استفاده باشند و از حفظ حریم خصوصی کاربران اطمینان حاصل شود.

نصب و راه‌اندازی پکیج SMSRocket

برای استفاده از پکیج SMSRocket در پروژه‌های CodeIgniter 4 خود، مراحل ساده‌ای وجود دارد که در ادامه توضیح داده می‌شود:

1. نصب پکیج

ابتدا پکیج را از طریق Composer نصب کنید:

composer require datamweb/sms-rocket

2. پیکربندی پکیج

پس از نصب، فایل پیکربندی پکیج را در مسیر app/config کپی کرده و تنظیمات مربوط به درایور پیامک خود را وارد کنید. به‌طور مثال، برای استفاده از درایور Twilio، تنظیمات آن به این صورت خواهد بود:

// app/config/SMSRocket.php

public $twilio = [
    'sid' => env('TWILIO_SMS_ACCOUNT_SID'),
    'token' => env('TWILIO_SMS_AUTH_TOKEN'),
    'sender' => env('TWILIO_SMS_SENDER'),
    'messaging_service_sid' => env('TWILIO_SMS_MESSAGING_SERVICE_SID'),
];

1. همچنین، شما می‌توانید تنظیمات دیگر مانند Farazsms، AmootSMS،ایده پردازان و...را به همین شکل پیکربندی کنید.

3. ارسال پیامک

پس از انجام تنظیمات، می‌توانید از پکیج SMSRocket برای ارسال پیامک استفاده کنید. به‌عنوان مثال، ارسال پیامک با استفاده از درایور Twilio:

/** @var SMSRocketService $smsService */
$smsService = service('smsRocket');

$twilio = $smsService->driver('twilio')
        ->setSender('+120XXXXXX') // شماره فرستنده
        ->setReceiver('+9809118840000')  // شماره گیرنده
        ->setMessage('تیکت شما با موفقیت ایجاد شد.')
        ->send();

در این کد، شماره فرستنده، گیرنده و متن پیام را مشخص کرده‌ایم و پیامک به گیرنده ارسال خواهد شد.

4. ارسال پیامک با الگو

اگر نیاز دارید که پیامک‌های خود را با الگو ارسال کنید (مثلاً برای ارسال کد تایید یا فاکتور)، می‌توانید از ویژگی Patterned SMS استفاده کنید:

$farazsms = $smsService->driver('farazsms')
    ->setPattern('3021') // کد الگو
    ->setPatternData([    // داده‌های مورد نیاز برای الگو
        'order_code' => '1234',
    ])
    ->send('09123456789');

if ($farazsms->isOK()) {
    echo &quotپیامک الگو شما با موفقیت ارسال شد. شناسه پیام: {$farazsms->getMessageId()}&quot
}

نتیجه‌گیری

پکیج SMSRocket ابزاری بسیار مفید و قدرتمند برای ارسال پیامک در پروژه‌های CodeIgniter 4 است. با پشتیبانی از چندین درایور مختلف، قابلیت ارسال پیامک‌های ساده و الگو دار، و پیکربندی آسان، این پکیج می‌تواند به شما در ارسال پیامک‌های سریع و کارآمد کمک کند. اگر شما هم به دنبال یک راه‌حل ساده و قابل اعتماد برای ارسال پیامک در پروژه‌های خود هستید، SMSRocket می‌تواند گزینه مناسبی باشد.

برای اطلاعات بیشتر و دسترسی به مستندات کامل، به مستندات آنلاین SMSRocket مراجعه کنید.