مولد التقارير لـ PHP

مكتبة PHP لإنشاء تقارير مخصصة للغاية باستخدام REST API.

  • GroupDocs.Assembly Cloud SDK لـ cURL
  • GroupDocs.Assembly Cloud SDK لـ .NET
  • GroupDocs.Assembly Cloud SDK لـ Java
  • GroupDocs.Assembly Cloud SDK لـ Python
  • GroupDocs.Assembly Cloud SDK لـ Ruby
  • GroupDocs.Assembly Cloud SDK لـ Node.js
  • GroupDocs.Assembly Cloud SDK لـ Go
  • GroupDocs.Assembly Cloud SDK لـ Swift
  • GroupDocs.Assembly Cloud SDK لـ C++
ابدأ التجربة المجانية

GroupDocs.Assembly Cloud SDK for PHP هو منصة شاملة قائمة على السحابة تمكّن المطورين من إنشاء مستندات مُنسَّقة بالكامل — من رسائل بسيطة إلى تقارير متعددة الصفحات ومعقّدة — مباشرةً من تطبيقات PHP. يعمل الحل بالكامل عبر HTTPS، لذا لا حاجة لأي برنامج مكتبي أو مكتبات ثقيلة على جانب العميل؛ جميع المعالجة الثقيلة تُجرى بواسطة خدمات GroupDocs Cloud.

يتبع SDK سير عمل واضح من ثلاث خطوات:

  1. تحضير قالب – ملف Word أو Excel أو PowerPoint أو أي ملف مدعوم يحتوي على حقول نائبة وقواعد توليد اختيارية مكتوبة بلغة تعبيرية على نمط LINQ.
  2. إنشاء مصدر بيانات – ملف XML أو JSON يحتوي على البيانات التي سيتم دمجها في القالب. يمكن للبيانات أن تمثل قيمًا بسيطة أو مجموعات معقدة ستحول إلى جداول أو مخططات أو أقسام متكررة.
  3. استدعاء Assembly API – باستخدام PHP SDK، تقوم بتحميل القالب (إذا لم يكن مخزنًا مسبقًا)، وتمرير مسار القالب، ومصدر البيانات، وصيغة الإخراج المطلوبة في طلب واحد من نوع AssembleDocument، وتستلم المستند المُجمّع كتيار أو كمرجع لملف مخزن في GroupDocs Cloud Storage.

كما يوفّر SDK ميزات قوية مثل الكتل الشرطية، المتغيّرات القابلة لإعادة الاستخدام، توليد الباركود، إنشاء مرفقات البريد الإلكتروني، وتنسيق كامل باستخدام HTML، مما يتيح بناء مستندات ديناميكية مدفوعة بالبيانات تتكيف مع أي قاعدة عمل. جميع العمليات مؤمّنة باستخدام SSL/TLS ومُصادقة بمفاتيح الوصول، لضمان عدم خروج البيانات السرية من القناة المشفّرة.

نظرًا لأن SDK يعتمد بالكامل على PHP ويستند إلى استدعاءات REST القياسية، فهو يعمل على أي نظام تشغيل يدعم PHP 5.6 + (بما في ذلك Windows، Linux وmacOS) ويتكامل بسلاسة مع Composer، خطوط أنابيب CI، أو أي عملية نشر مخصصة.

ميزات تجميع المستندات REST API

تجميع المستندات السحابي يُتاح عبر REST API

محرك القوالب مع حقول العنصر النائب

ربط تعبيرات بنمط LINQ لبيانات XML/JSON

تضمين الصور والرسوم البيانية والمستندات الخارجية

إنشاء جداول وقوائم ديناميكية من المصفوفات

إدراج الروابط التشعبية والإشارات المرجعية برمجيًا

تطبيق الصيغ وعمليات البيانات المتسلسلة

كتل محتوى شرطية (منطق IF‑ELSE)

متغيرات قابلة لإعادة الاستخدام للحسابات المكلفة

إنشاء الباركود مباشرةً في المستندات

إنشاء مستند في PHP

المقتطف أدناه يوضح سير العمل النموذجي لإنشاء مستند باستخدام Assembly Cloud PHP SDK:

  1. إنشاء مثيل AssemblyApi باستخدام App SID و App Key.
  2. رفع ملف القالب إلى GroupDocs Cloud Storage.
  3. تحميل مصدر البيانات (XML أو DOCX).
  4. تكوين AssembleOptions – حدد مسار القالب والبيانات وتنسيق الإخراج.
  5. استدعاء 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

Support and Learning Resources

GroupDocs.Assembly Cloud يقدم أيضًا SDKs للغات أخرى:

  عربي
4f0b7297e