Download the PHP package sobhansgh/torob-sync without Composer

On this page you can find all versions of the php package sobhansgh/torob-sync. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of sobhansgh/torob-sync

Informations about the package torob-sync

Torob Sync برای لاراول

Latest Version

اتصال هر فروشگاه لاراولی به ترب (Torob) بر اساس آخرین نسخه‌ی API رسمی ترب:

شما فقط باید به پکیج بگویید محصولات‌تان از کجا می‌آیند؛ باقی کارها (مسیر، احراز هویت، صفحه‌بندی، قالب پاسخ) توسط پکیج مدیریت می‌شود.

سازگار با Laravel 10, 11 و 12 و PHP 8.1+.

نصب

پکیج به‌صورت خودکار توسط Laravel شناسایی می‌شود (Package Auto-Discovery). سپس افزونه‌ی sodium باید در PHP شما فعال باشد (برای اعتبارسنجی امضای EdDSA):

اگر فعال نبود، در php.ini این خط را از حالت کامنت خارج کنید: extension=sodium

انتشار فایل کانفیگ

فایل config/torob-sync.php در پروژه‌ی شما ساخته می‌شود.

راه‌اندازی سریع (۳ مرحله)

مرحله ۱: ساخت کلاس اتصال محصولات

این دستور فایل app/Torob/TorobProductProvider.php را می‌سازد. این تنها فایلی است که باید تکمیل کنید:

برای محصولات ساده، همین کافی است. برای محصولات متغیر (مثلاً چند رنگ)، در ادامه توضیح داده شده.

مرحله ۲: تنظیم .env

مرحله ۳: ثبت آدرس نزد ترب

آدرس endpoint شما به‌صورت پیش‌فرض این خواهد بود (مطابق مثال‌های مستندات ترب):

این آدرس را در پنل/فرم ثبت‌نام ترب وارد کنید تا ترب شروع به دریافت محصولات شما کند. کلید عمومی ترب و اعتبارسنجی JWT به‌صورت کامل در پکیج پیاده‌سازی شده و نیازی به کار اضافه نیست.

پشتیبانی از محصولات متغیر (Variant)

طبق مستندات ترب، واریانت‌های یک محصول (مثلاً رنگ‌های مختلف) باید یک product_group_id مشترک و page_unique جداگانه داشته باشند:

برای محصول ساده فقط کافی است groupId() را صدا نزنید.

ارسال وبهوک (اطلاع‌رسانی سریع تغییر محصول)

به‌جای منتظر ماندن برای کراول دوره‌ای ترب، هر بار که محصولی اضافه یا ویرایش شد می‌توانید به ترب اطلاع دهید (نیازمند توکن که از پشتیبانی ترب دریافت می‌کنید):

بهترین‌جا برای صدا زدن این متد، Observer مدل محصول شماست (رویدادهای created و updated):

طبق مستندات ترب، محدودیت نرخ درخواست وبهوک ۲۰ درخواست در دقیقه به ازای هر فروشگاه است؛ در صورت نیاز به ارسال حجم بالا، صف (Queue) لاراول را برای این متد استفاده کنید.

متغیرهای محیطی (.env)

متغیر توضیح پیش‌فرض
TOROB_PROVIDER کلاس اتصال محصولات شما App\Torob\TorobProductProvider
TOROB_ROUTE_PREFIX پیشوند آدرس endpoint torob_api/v3
TOROB_ROUTE_DOMAIN دامنه‌ی اختصاصی روت (اختیاری) —
TOROB_PUBLIC_KEY کلید عمومی ترب برای JWT مقدار رسمی ترب
TOROB_AUD مقدار دستی aud (فقط پشت پروکسی خاص) Host درخواست
TOROB_WEBHOOK_URL آدرس وبهوک ترب https://api.torob.com/update/webhook/v1/
TOROB_WEBHOOK_TOKEN توکن وبهوک (از پشتیبانی ترب) —

چگونه کار می‌کند؟

  1. ترب یک درخواست POST با هدر X-Torob-Token (JWT با الگوریتم EdDSA) به route.prefix + /products شما می‌زند.
  2. میدل‌ور داخلی پکیج (VerifyTorobToken) امضا، تاریخ انقضا و aud توکن را با کلید عمومی ترب اعتبارسنجی می‌کند.
  3. بسته به بدنه‌ی درخواست، یکی از متدهای paginate / findByUrls / findByUniques از کلاس Provider شما صدا زده می‌شود.
  4. پکیج خروجی را دقیقاً مطابق فرمت torob_api_v3 قالب‌بندی و برمی‌گرداند.

تست دستی endpoint

منابع

توسعه‌دهنده

ساخته‌شده توسط Sobhan Ghasemi — GitHub

لایسنس

این پکیج تحت لایسنس MIT منتشر شده است.

All versions of torob-sync with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
ext-sodium Version *
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
firebase/php-jwt Version ^6.9
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package sobhansgh/torob-sync contains the following files

Loading the files please wait ...