تحرير المستندات باستخدام REST API في PHP.

يمكننا إضافة أو تعديل أو حذف محتوى مستندات Word الحالية أو جداول بيانات Excel أو الملفات النصية برمجيًا على السحابة. يمكننا أيضًا تطبيق تنسيق النص في المستندات باستخدام PHP دون تثبيت أي تطبيق خارجي. في هذه المقالة ، سنتعلم كيفية تحرير المستندات باستخدام REST API في PHP.

سيتم تناول الموضوعات التالية في هذه المقالة:

محرر المستندات REST API و PHP SDK

سنستخدم PHP SDK of GroupDocs.Editor Cloud API لتعديل ملفات DOCX و XLSX و TXT. يسمح بتحرير المستندات من التنسيقات المدعومة. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:

composer require groupdocscloud/groupdocs-editor-cloud

بعد التثبيت ، يرجى استخدام التحميل التلقائي للملحنين لاستخدام SDK كما هو موضح أدناه:

require_once('vendor/autoload.php');

يرجى الحصول على معرف العميل والسرية من لوحة التحكم قبل اتباع الخطوات المذكورة. بمجرد حصولك على المعرف والسر الخاص بك ، قم بإضافة الرمز كما هو موضح أدناه:

// يوضح مثال الكود هذا كيفية إضافة معرف العميل والسر في الكود.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';
static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';

// تهيئة التكوين
$configuration = new GroupDocs\Editor\Configuration();

// ضبط التكوينات
$configuration->setAppSid(CommonUtils::$ClientId);
$configuration->setAppKey(CommonUtils::$ClientSecret);
$configuration->setApiBaseUrl(CommonUtils::$ApiBaseUrl);

تحرير مستندات Word باستخدام REST API في PHP

يمكننا تحرير مستندات Word باتباع الخطوات البسيطة المذكورة أدناه:

  1. تحميل ملف DOCX إلى السحابة
  2. تحرير مستند Word الذي تم تحميله
  3. تحميل الملف المحرر

قم بتحميل المستند

أولاً ، سنقوم بتحميل ملف DOCX إلى السحابة باستخدام نموذج الرمز الوارد أدناه:

// يوضح مثال الرمز هذا كيفية تحميل ملف DOCX إلى السحابة.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Editor\FileApi($configuration);

// مسار ملف الإدخال
$file = "C:\\Files\\Editor\\sample.docx";

// طلب رفع الملف
$request = new GroupDocs\Editor\Model\Requests\uploadFileRequest("sample.docx", $file, self::$MyStorage, null);

// رفع ملف
$response = $apiInstance->uploadFile($request);

نتيجة لذلك ، سيكون ملف DOCX الذي تم تحميله متاحًا في قسم الملفات من لوحة المعلومات على السحابة.

تحرير مستند Word في PHP

الآن ، سنقوم بتحرير محتوى ملف DOCX الذي تم تحميله باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيلات من FileApi و EditApi.
  • بعد ذلك ، قم بتوفير مسار ملف DOCX الذي تم تحميله.
  • بعد ذلك ، قم بتنزيل الملف كمستند HTML.
  • بعد ذلك ، اقرأ ملف HTML الذي تم تنزيله كسلسلة.
  • بعد ذلك ، قم بتحرير HTML وحفظ مستند HTML المحدث.
  • بعد ذلك ، قم بتحميل ملف HTML المحدث.
  • أخيرًا ، احفظ HTML مرة أخرى إلى DOCX باستخدام طريقة EditApi.save().

يوضح نموذج التعليمات البرمجية التالي كيفية تحرير مستند Word باستخدام REST API في PHP.

// يوضح مثال التعليمات البرمجية هذا كيفية تحرير مستند Word
// إنشاء مثيلات API الضرورية
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// قم بتحميل ملف DOCX الذي تم تحميله إلى حالة قابلة للتحرير
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.docx");

// قم بتعيين كلمة المرور إذا كانت محمية بكلمة مرور
// $ fileInfo->setPassword ("كلمة المرور") ؛

// تحديد خيارات التحميل
$loadOptions = new Model\WordProcessingLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// قم بتنزيل مستند HTML
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

// تحرير النص
$html = str_replace("Title of the document", "Welcome", $html);
$html = str_replace("Subtitle #1", "This is Subtitle", $html);

// قم بتحميل HTML مرة أخرى إلى التخزين
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// احفظ HTML مرة أخرى في DOCX
$saveOptions = new Model\WordProcessingSaveOptions();
$saveOptions->setFileInfo($fileInfo);
$saveOptions->setOutputPath("edited.docx");
$saveOptions->setHtmlPath($loadResult->getHtmlPath());
$saveOptions->setResourcesPath($loadResult->getResourcesPath());
$saveResult = $editApi->save(new Requests\saveRequest($saveOptions));

// منتهي.
echo "Document edited: " . $saveResult->getPath();
تحرير مستندات Word باستخدام REST API في PHP.

قم بتحرير مستند Word باستخدام REST API في PHP.

قم بتنزيل الملف المحدث

سيحفظ نموذج الكود أعلاه ملف Word المحرر (DOCX) على السحابة. يمكن تنزيله باستخدام نموذج التعليمات البرمجية التالي:

// يوضح مثال الرمز هذا كيفية تنزيل ملف DOCX من السحابة.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Editor\FileApi($configuration);

// طلب تحميل الملف
$request = new GroupDocs\Editor\Model\Requests\DownloadFileRequest("edited.docx", self::$MyStorage, null);

// تحميل الملف
$response = $apiInstance->downloadFile($request);

تعديل جداول بيانات Excel باستخدام REST API في PHP

يمكننا تحرير محتوى ورقة Excel باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج فقط إلى توفير مسار ملف XLSX الذي تم تحميله.

يوضح نموذج التعليمات البرمجية التالي كيفية تحرير بيانات ورقة Excel باستخدام واجهة برمجة تطبيقات REST في PHP.

// يوضح مثال التعليمات البرمجية هذا كيفية تحرير ورقة Excel
// إنشاء مثيلات API الضرورية
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// قم بتحميل ملف XLSX الذي تم تحميله إلى حالة قابلة للتحرير
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.xlsx"); 

// تحديد خيارات التحميل
$loadOptions = new Model\SpreadsheetLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadOptions->setWorksheetIndex(0);
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// قم بتنزيل مستند HTML
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

// تحرير شيء ما ...
$html = str_replace("Region", "Country", $html);
$html = str_replace("Europe", "France", $html);
$html = str_replace("Asia", "China", $html);
$html = str_replace("South America", "Argentina", $html);

// قم بتحميل HTML مرة أخرى إلى التخزين
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// احفظ HTML مرة أخرى إلى XLSX
$saveOptions = new Model\SpreadsheetSaveOptions();
$saveOptions->setFileInfo($fileInfo);
$saveOptions->setOutputPath("edited.xlsx");
$saveOptions->setHtmlPath($loadResult->getHtmlPath());
$saveOptions->setResourcesPath($loadResult->getResourcesPath());
$saveResult = $editApi->save(new Requests\saveRequest($saveOptions));

// منتهي.
echo "Document edited: " . $saveResult->getPath();
تعديل جداول بيانات Excel باستخدام REST API في PHP.

قم بتعديل جدول بيانات Excel باستخدام واجهة برمجة تطبيقات REST في PHP.

تحديث الملفات النصية باستخدام REST API في PHP

يمكننا أيضًا تحديث محتوى ملف نصي باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج فقط إلى توفير مسار ملف TXT الذي تم تحميله.

يوضح نموذج التعليمات البرمجية التالي كيفية تحرير ملف نصي باستخدام REST API في PHP.

// يوضح مثال التعليمات البرمجية هذا كيفية تحرير ملف نصي
// إنشاء مثيلات API الضرورية
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// قم بتحميل ملف TXT الذي تم تحميله إلى حالة قابلة للتعديل
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.txt");        
$loadOptions = new Model\TextLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// قم بتنزيل مستند HTML
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

// تحرير النص
$html = str_replace("Title of the document", "Welcome", $html);
$html = str_replace("Subtitle #1", "This is Subtitle", $html);

// قم بتحميل HTML مرة أخرى إلى التخزين
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// احفظ HTML مرة أخرى إلى TXT
$saveOptions = new Model\TextSaveOptions();
$saveOptions->setFileInfo($fileInfo);
$saveOptions->setOutputPath("edited.txt");
$saveOptions->setHtmlPath($loadResult->getHtmlPath());
$saveOptions->setResourcesPath($loadResult->getResourcesPath());
$saveResult = $editApi->save(new Requests\saveRequest($saveOptions));

// منتهي.
echo "Document edited: " . $saveResult->getPath();
تحديث الملفات النصية باستخدام REST API في PHP.

تحديث ملف نصي باستخدام REST API في PHP.

جرب عبر الإنترنت

يرجى تجربة أدوات تحرير المستندات المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه.

خاتمة

في هذه المقالة ، تعلمنا كيفية:

  • تحرير أو تعديل محتوى Word أو Excel أو الملفات النصية في PHP ؛
  • تحميل ملف DOCX إلى السحابة ؛
  • قم بتنزيل ملف Word المحدث من السحابة.

بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Editor Cloud API باستخدام التوثيق. نقدم أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا