ערכת פיתוח התוכנה GroupDocs.Assembly Cloud SDK עבור PHP היא פלטפורמה מקיפה מבוססת ענן המאפשרת למפתחים ליצור מסמכים בפורמט מלא - ממכתבים פשוטים ועד דוחות מורכבים מרובי עמודים - ישירות מיישומי PHP. הפתרון פועל כולו דרך HTTPS, כך שאין צורך בתוכנות משרדיות או בספריות כבדות בצד הלקוח; כל העבודה הקשה מבוצעת על ידי שירותי GroupDocs Cloud.
ערכת פיתוח התוכנה (SDK) פועלת לפי תהליך עבודה ברור בן שלושה שלבים:
הכנת תבנית - קובץ Word, Excel, PowerPoint או כל קובץ נתמך המכיל שדות placeholder וכללי יצירה אופציונליים שנכתבו בשפת ביטויים בסגנון LINQ.
יצירת מקור נתונים - קובץ XML או JSON המכיל את הנתונים שימוזגו לתבנית. הנתונים יכולים לתאר ערכים סקלריים פשוטים או אוספים מורכבים שיהפכו לטבלאות, תרשימים או מקטעים חוזרים.
קריאה ל-Assembly API – באמצעות PHP SDK אתם מעלים את התבנית (אם היא עדיין לא מאוחסנת), מעבירים את נתיב התבנית, מקור הנתונים ופורמט הפלט הרצוי לבקשת AssembleDocument אחת, ומקבלים את המסמך המורכב כזרם או כהפניה לקובץ המאוחסן ב-GroupDocs Cloud Storage.
ה-SDK מציע בנוסף תכונות עוצמתיות כגון בלוקים מותנים, משתנים לשימוש חוזר, יצירת ברקודים, יצירת קבצים מצורפים לדוא"ל ועיצוב HTML מלא, מה שמאפשר לבנות מסמכים דינמיים ומונעי נתונים שמתאימים לכל כלל עסקי. כל הפעולות מאובטחות באמצעות SSL/TLS ומאומתות באמצעות מפתחות גישה, מה שמבטיח שנתונים סודיים לעולם לא יעזבו את הערוץ המוצפן.
מכיוון שה-SDK הוא PHP טהור ומסתמך על קריאות REST סטנדרטיות, הוא פועל על כל מערכת הפעלה התומכת ב-PHP5.6+ (כולל Windows, Linux ו-macOS) ומשתלב בצורה חלקה עם Composer, CI pipelines או כל תהליך פריסה מותאם אישית.
הקטע למטה מדגים את תהליך העבודה האופייני ליצירת מסמך עם 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('......##', '......##'); // החלף באישורים שלך
$fileName = "Input1.docx"; // שם קובץ התבנית
$dataFile = "Input2.docx"; // קובץ מקור נתונים (XML או DOCX)
// העלאת תבנית לאחסון ענן
$requestFileContent = $fileName;
$uploadDocumentRequest = new UploadFileRequest($requestFileContent, $fileName, NULL);
$assemblyApi->uploadFile($uploadDocumentRequest);
// קריאת מקור נתונים
$reportData = file_get_contents($dataFile);
// הגדרת אפשרויות הרכבה
$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); // התוצאה מכילה את המסמך שהורכב