تخطَّ إلى المحتوى الرئيسي
تصفّح التوثيق

PHP

تحقّق من نيّات وكيل Syncanix في PHP — Laravel وSymfony — بفحص HMAC محلي على كل استدعاء أداة.

توفّر حزمة SDK للغة PHP برمجية وسيطة لـ Laravel ومشترك أحداث لـ Symfony فوق نواة VerifyIntent مشتركة. احمِ بها مسارات أدواتك واقرأ الحمولة المفكوكة من سمات الطلب.

التثبيت

أضف الحزمة إلى مشروعك بمدير الحزم الخاص بلغتك.

composer require syncanix/sdk-php

ضبط السرّ

تتحقق حزمة SDK من النيّات بسرّ توقيع النيّة الخاص بمستأجرك. خزّنه كمتغيّر بيئة — ولا تودعه في نظام إدارة الشيفرة أبدًا — وحمِّله حيث تسجّل حزمة SDK.

export SYNCANIX_SECRET="your-intent-signing-secret"

التحقق من النيّات

سجِّل حزمة SDK على المسارات التي تعرض إجراءات الوكيل. فهي تتحقق من ترويسة X-Syncanix-Intent قبل تشغيل معالِجك، وترفض أي استدعاء غير صالح أو مُعاد إرساله بالرمز 403، وتسلّم معالِجك الحمولة المتحقَّق منها — بما فيها المستأجر والمستخدم الفاعلان.

Route::middleware(SyncanixIntentMiddleware::class . ':' . env('SYNCANIX_SECRET'))
    ->group(function () {
        Route::post('/tools/refund', function (Request $request) {
            $intent = $request->attributes->get('syncanix_intent');
            return response()->json(['tenantId' => $intent->tenantId]);
        });
    });
التحقق من نيّة على مسار أداة. عند النجاح تكون الحمولة المتحقَّق منها متاحة لمعالِجك؛ وعند الفشل تعيد حزمة SDK الرمز 403 قبل أن تعمل شيفرتك.

الخطوات التالية