PHPackages pishropayamak/sms - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. pishropayamak/sms ActiveLibrary pishropayamak/sms ================= پکیج رسمی ارسال پیامک پیشرو پیامک برای لاراول - پشتیبانی کامل از REST API v3 v2.0.5(2w ago)011MITPHPPHP ^8.0 Since Jul 17Pushed 2w agoCompare [ Source](https://github.com/MohammadrezaRahpeyma/pishropayamak-sms)[ Packagist](https://packagist.org/packages/pishropayamak/sms)[ Docs](https://pishropayamak.ir)[ RSS](/packages/pishropayamak-sms/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (6)Versions (3)Used By (0) 📱 مستندات کامل پکیج رسمی پیشرو پیامک برای لاراول (نسخه ۲.۰.۰) پکیج رسمی پیشرو پیامک برای ارسال آسان و حرفه‌ای پیامک در پروژه‌های لاراول. این پکیج با پشتیبانی از وب سرویس REST نسخه ۳، امکانات کامل ارسال، دریافت، وضعیت‌یابی، مدیریت دفترچه تلفن و لیست سیاه را در اختیار شما قرار می‌دهد. ✨ ویژگی‌های کلیدی ``` احراز هویت امن با توکن به جای نام کاربری و رمز عبور ارسال پیامک ساده و گروهی (چند پیام متفاوت) دریافت وضعیت و جزئیات پیام‌های ارسال شده دریافت لیست پیام‌های ارسالی و دریافتی با صفحه‌بندی دریافت پیام‌های خوانده‌نشده و بروزرسانی خودکار وضعیت مدیریت دفترچه تلفن (ایجاد، حذف، افزودن/حذف شماره) مدیریت لیست سیاه (افزودن، حذف، بررسی وجود) دریافت اعتبار و اطلاعات کامل کاربر ثبت‌نام کاربر جدید از طریق وب سرویس کاملاً سازگار با لاراول ۹، ۱۰، ۱۱ و ۱۲ Auto-Discovery در لاراول مدیریت خطاهای حرفه‌ای با Exception‌های اختصاصی ``` 📦 نصب bash composer require pishropayamak/sms ⚙️ تنظیمات انتشار فایل کانفیگ (اختیاری) bash php artisan vendor:publish --tag=pishropayamak-config متغیرهای محیطی در فایل .env env PISHROPAYAMAK\_TOKEN=your\_token\_here PISHROPAYAMAK\_FROM=9444xxxxxx PISHROPAYAMAK\_TYPE=0 PISHROPAYAMAK\_BASE\_URL=PISHROPAYAMAK\_TIMEOUT=30 متغیر توضیح PISHROPAYAMAK\_TOKEN توکن دریافتی از پنل کاربری (اجباری) PISHROPAYAMAK\_FROM شماره خط اختصاصی (اختیاری) PISHROPAYAMAK\_TYPE نوع پیام پیش‌فرض: ۰=معمولی، ۱=فلش PISHROPAYAMAK\_BASE\_URL آدرس پایه API (نسخه ۳) PISHROPAYAMAK\_TIMEOUT تایم‌اوت درخواست به ثانیه 🚀 نحوه استفاده روش اول: استفاده از Facade (ساده‌ترین) php use PishroPayamak\\Sms\\Facades\\PishroPayamak; $response = PishroPayamak::sendSms( '9444xxxxxx', \['09121234567', '09129876543'\], 'متن پیام شما', 0 ); if ($response\['return'\]\['status'\] == 200) { echo "✅ کد پیگیری: " . $response\['data'\]\['messageid'\]; } else { echo "❌ خطا: " . $response\['return'\]\['message'\]; } روش دوم: تزریق وابستگی (Dependency Injection) php use PishroPayamak\\Sms\\SmsService; class SmsController extends Controller { public function send(SmsService $sms) { $response = $sms->sendSms( '9444xxxxxx', \['09121234567'\], 'متن پیام شما' ); ``` return response()->json($response); } ``` } روش سوم: استفاده از app() helper php $sms = app('pishropayamak.sms'); $response = $sms->sendSms('9444xxxxxx', \['09121234567'\], 'متن پیام شما'); 📋 متدهای کامل پکیج 🟢 سرویس پیامک (SMS) متد توضیح sendSms($from, $recipients, $message, $type) ارسال پیامک به یک یا چند گیرنده sendMultiple($fromArray, $recipients, $messageArray, $typeArray) ارسال گروهی با پیام‌های متفاوت getStatus($messageIds) دریافت وضعیت پیام‌ها (حداکثر ۵۰ عدد) getSelect($messageIds) دریافت جزئیات کامل پیام‌ها getOutbox($startDate, $endDate) لیست ارسال‌ها در بازه زمانی getLatest() آخرین وضعیت پیام ارسال‌شده getLatestOutbox($pageSize) آخرین ارسال‌ها (حداکثر ۲۰۰) countOutbox($startDate, $endDate) تعداد ارسال‌ها در بازه زمانی countInbox($startDate, $endDate, $number, $isRead) تعداد دریافت‌ها با فیلتر getInbox($count, $offset) دریافت پیام‌های دریافتی getInboxPaged($number, $isRead, $page, $pageSize) دریافت پیام‌های دریافتی با صفحه‌بندی receive($number, $isRead) دریافت پیام‌های خوانده‌نشده و بروزرسانی getStatusByNumber($number, $startDate, $pageSize) وضعیت پیام‌های یک شماره خاص 🟢 سرویس کاربر (User) متد توضیح getCredit() دریافت اعتبار باقی‌مانده (ریال) getUserDetails() دریافت اطلاعات کامل کاربر registerUser($uname, $passwd, $passwd\_repeat, $parent, $mobile, $melli\_code, $package, $reseller) ثبت‌نام کاربر جدید 🟢 دفترچه تلفن (Phonebook) متد توضیح getPhonebooks($name) فهرست دفترچه‌های تلفن getPhonebookNumbers($book\_id) شماره‌های یک دفترچه createPhonebook($name, $numbers, $flag) ایجاد دفترچه جدید deletePhonebook($book\_id) حذف دفترچه addToPhonebook($book\_id, $numbers, $flag) افزودن شماره به دفترچه removeFromPhonebook($book\_id, $numbers, $flag) حذف شماره از دفترچه 🟢 لیست سیاه (Blocked) متد توضیح getBlockedList($number, $startDate, $page, $pageSize) دریافت لیست سیاه یک خط addToBlocked($number, $targets) افزودن شماره به لیست سیاه removeFromBlocked($number, $target) حذف شماره از لیست سیاه isBlocked($number, $targets) بررسی وجود شماره در لیست سیاه 📝 پارامترهای متد sendSms پارامتر نوع ضروری توضیح $from string بله شماره خط اختصاصی $recipients array بله لیست گیرندگان (حداکثر ۲۰۰ عدد) $message string بله متن پیام (حداکثر ۹۰۰ کاراکتر) $type int خیر ۰=معمولی، ۱=فلش (پیش‌فرض ۰) 📤 ساختار خروجی ✅ در صورت موفقیت php \[ 'return' => \[ 'status' => 200, 'message' => 'پیام با موفقیت در صف ارسال قرار گرفت' \], 'data' => \[ 'messageid' => 8792343, 'message' => 'متن پیام', 'state' => 'فعال', 'from' => '9444xxxxxx', 'date' => 1786619709 \] \] ❌ در صورت خطا php \[ 'return' => \[ 'status' => 401, 'message' => 'توکن نامعتبر است' \] \] 🧪 مدیریت خطاها php use PishroPayamak\\Sms\\Facades\\PishroPayamak; use PishroPayamak\\Sms\\Exceptions\\AuthenticationException; use PishroPayamak\\Sms\\Exceptions\\ValidationException; use PishroPayamak\\Sms\\Exceptions\\SmsException; try { $response = PishroPayamak::sendSms('9444xxxxxx', \['09121234567'\], 'متن'); } catch (AuthenticationException $e) { // توکن نامعتبر یا منقضی Log::error('خطای احراز هویت: ' . $e->getMessage()); } catch (ValidationException $e) { // پارامترهای ورودی نامعتبر Log::error('خطای اعتبارسنجی: ' . $e->getMessage()); } catch (SmsException $e) { // سایر خطاهای سرویس Log::error('خطای سرویس: ' . $e->getMessage()); } 🔒 نکات امنیتی ``` توکن را هرگز در کد قرار ندهید؛ همیشه از متغیرهای محیطی استفاده کنید. برای ارتباط با سرور از پروتکل HTTPS استفاده می‌شود. توکن‌ها دارای تاریخ انقضا هستند؛ به‌طور دوره‌ای آنها را تمدید کنید. در صورت پایان کار، توکن را از پنل کاربری باطل کنید. ``` 🧪 تست bash composer test 📚 منابع و مستندات بیشتر ``` وب‌سایت رسمی: https://pishropayamak.ir مستندات کامل API: https://pishropayamak.ir/api/v3/rest مخزن گیت‌هاب: https://github.com/MohammadrezaRahpeyma/pishropayamak-sms پشتیبانی: mr.rezarahpeyma@gmail.com ``` 📄 مجوز این پکیج تحت مجوز MIT منتشر شده است. 🙏 مشارکت اگر مشکلی پیدا کردید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم که در مخزن گیت‌هاب Issue ایجاد کنید یا Pull Request ارسال نمایید. ساخته شده با ❤️ توسط پیشرو پیامک ### Health Score 39 — LowBetter than 84% of packages Maintenance96 Actively maintained with recent releases Popularity7 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~26 days Total 2 Last Release 19d ago Major Versions v1.0.0 → v2.0.52026-08-13 ### Community Maintainers ![](https://www.gravatar.com/avatar/29ac0136fda2b33805976fcf77f221df6b445b826a7d6afe4380caf4536cba8f?d=identicon)[mrrahpeyma](/maintainers/mrrahpeyma) --- Top Contributors [![MohammadrezaRahpeyma](https://avatars.githubusercontent.com/u/120649219?v=4)](https://github.com/MohammadrezaRahpeyma "MohammadrezaRahpeyma (2 commits)") --- Tags laravelsmsREST APISMS Servicepishropayamakپیشرو پیامک ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/pishropayamak-sms/health.svg) ``` [![Health](https://phpackages.com/badges/pishropayamak-sms/health.svg)](https://phpackages.com/packages/pishropayamak-sms) ``` ### Alternatives [laravel/ai The official AI SDK for Laravel. 1.1k6.4M362](/packages/laravel-ai)[psalm/plugin-laravel Psalm plugin for Laravel 3365.5M359](/packages/psalm-plugin-laravel)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 24795.1k](/packages/harris21-laravel-fuse)[erag/laravel-lang-sync-inertia A powerful Laravel package for syncing and managing language translations across backend and Inertia.js (Vue/React/Svelte) frontends, offering effortless localization, auto-sync features, and smooth multi-language support for modern Laravel applications. 6036.2k](/packages/erag-laravel-lang-sync-inertia)[api-platform/laravel API Platform support for Laravel 58190.1k22](/packages/api-platform-laravel)[spatie/laravel-flare Send Laravel errors to Flare 131.8M9](/packages/spatie-laravel-flare) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)