> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# Agent PHP SDK

<h2 id="runtime">
  مدة العرض
</h2>

| العنصر                | القيمة                                 |
| --------------------- | -------------------------------------- |
| الحزمة                | Sixmm/Agent-SDK                        |
| النسخة PHP الأدنى     | PHP 7.4+                               |
| النسخة PHP الموصى بها | PHP إصدار 8.1+ أو النسخ المدعومة حاليا |
| التمديدات المطلوبة    | ext-json، ext-curl                     |

يتم توفير مصدر الحزمة PHP SDK والنسخة المعتمدة أثناء انضمام الشركاء. لا تفترض أن الحزمة متاحة من Packagist العام؛ قم بتكوين مستودع المؤلف المقدم لمؤسستك.

<h2 id="supported-scenarios">
  السيناريوهات المدعومة
</h2>

| السيناريو          | طريقة SDK               |
| ------------------ | ----------------------- |
| مستخدم الربط       | ربط                     |
| تحويل مبلغ ثابت    | النقل                   |
| انقل كل شيء        | transferAllOut          |
| النقل العكسي       | العكس                   |
| ترتيب الاستعلام    | queryOrder              |
| إنشاء URL          | createEntryUrl          |
| التحقق عبر Webhook | WebhookVerifier::verify |

<h2 id="backend-integration-rules">
  قواعد التكامل في الواجهة الخلفية
</h2>

* تحميل `apiSecret` من مدير سري أو متغير بيئة محمية.
* إبقاء ربط المستخدم، والنقل، والتوقيع، ومنطق webhook خارج كود المتصفح.
* استخدام سلاسل عشرية لمبالغ الأصول لتجنب تقريب النقطة العائمة.
* إعادة استخدام `agentOrderNo` الأصلي عند الاستعلام عن نتيجة نقل غير مؤكدة.
* التحقق من توقيعات webhook مقابل جسم الطلب الخام قبل فك ترميزها أو تغييرها.

<h2 id="next-steps">
  الخطوات التالية
</h2>

* \[PHP Quick Start] (/sdk/agent-sdk/php/quick-start): تكوين Composer وتهيئة العميل.

* \[Agent SDK نظرة عامة ] (/sdk/agent-sdk/overview): مراجعة تدفق التكامل الكامل للواجهة الخلفية.

* \[الأسرار والإشارة] (/sdk/security/secrets-signing): حماية المؤهلات وفهم HMAC التوقيع.

* [Webhooks & Idempotency](/ar/sdk/security/webhooks-idempotency): معالجة الاستدعاءات المتكررة بأمان.
  <h2 id="localized-page-links">صفحات ذات صلة</h2>

* [PHP البداية السريعة](/ar/sdk/agent-sdk/php/quick-start)

* [6MM Agent SDK Java PHP](/ar/sdk/agent-sdk/overview)

* [Agent SDK أسرار وتوقيع HMAC](/ar/sdk/security/secrets-signing)