GroupDocs.Assembly Cloud SDK for PHP هو منصة شاملة قائمة على السحابة تمكّن المطورين من إنشاء مستندات مُنسَّقة بالكامل — من رسائل بسيطة إلى تقارير متعددة الصفحات ومعقّدة — مباشرةً من تطبيقات PHP. يعمل الحل بالكامل عبر HTTPS، لذا لا حاجة لأي برنامج مكتبي أو مكتبات ثقيلة على جانب العميل؛ جميع المعالجة الثقيلة تُجرى بواسطة خدمات GroupDocs Cloud.
يتبع SDK سير عمل واضح من ثلاث خطوات:
AssembleDocument، وتستلم المستند المُجمّع كتيار أو كمرجع لملف مخزن في GroupDocs Cloud Storage.كما يوفّر SDK ميزات قوية مثل الكتل الشرطية، المتغيّرات القابلة لإعادة الاستخدام، توليد الباركود، إنشاء مرفقات البريد الإلكتروني، وتنسيق كامل باستخدام HTML، مما يتيح بناء مستندات ديناميكية مدفوعة بالبيانات تتكيف مع أي قاعدة عمل. جميع العمليات مؤمّنة باستخدام SSL/TLS ومُصادقة بمفاتيح الوصول، لضمان عدم خروج البيانات السرية من القناة المشفّرة.
نظرًا لأن SDK يعتمد بالكامل على PHP ويستند إلى استدعاءات REST القياسية، فهو يعمل على أي نظام تشغيل يدعم PHP 5.6 + (بما في ذلك Windows، Linux وmacOS) ويتكامل بسلاسة مع Composer، خطوط أنابيب CI، أو أي عملية نشر مخصصة.
المقتطف أدناه يوضح سير العمل النموذجي لإنشاء مستند باستخدام Assembly Cloud PHP SDK:
AssemblyApi باستخدام App SID و App Key.AssembleOptions – حدد مسار القالب والبيانات وتنسيق الإخراج.assembleDocument واسترجاع الملف المُجمّع.use GroupDocs\Assembly\AssemblyApi;
use GroupDocs\Assembly\Model;
use GroupDocs\Assembly\Requests;
$assemblyApi = new AssemblyApi('####################', '####################'); // replace with your credentials
$fileName = "Input1.docx"; // template file name
$dataFile = "Input2.docx"; // data source file (XML or DOCX)
// Upload template to Cloud Storage
$requestFileContent = $fileName;
$uploadDocumentRequest = new UploadFileRequest($requestFileContent, $fileName, NULL);
$assemblyApi->uploadFile($uploadDocumentRequest);
// Read data source
$reportData = file_get_contents($dataFile);
// Set assemble options
$assembleData = new Model\AssembleOptions([
"template_file_info" => new Model\TemplateFileInfo(["file_path" => $fileName]),
"save_format" => "docx",
"report_data" => $reportData
]);
$request = new Requests\AssembleDocumentRequest($assembleData);
$result = $assemblyApi->assembleDocument($request); // result contains the assembled document