ویرایش اسناد با استفاده از REST API در PHP.

ما می‌توانیم محتوای اسناد ورد، صفحات گسترده اکسل یا فایل‌های متنی موجود را به صورت برنامه‌نویسی در فضای ابری اضافه، ویرایش یا حذف کنیم. همچنین می‌توانیم قالب‌بندی متن را با استفاده از PHP بدون نصب هیچ برنامه خارجی در اسناد اعمال کنیم. در این مقاله یاد می گیریم که چگونه اسناد را با استفاده از REST API در PHP ویرایش کنیم.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

ویرایشگر سند REST API و PHP SDK

ما از PHP SDK of GroupDocs.Editor Cloud API برای اصلاح فایل‌های DOCX، XLSX و TXT استفاده خواهیم کرد. این اجازه می دهد تا اسناد [فرمت های پشتیبانی شده] را ویرایش کنید. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:

composer require groupdocscloud/groupdocs-editor-cloud

پس از نصب، لطفاً از Composers’ autoload برای استفاده از SDK مطابق شکل زیر استفاده کنید:

require_once('vendor/autoload.php');

لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 7 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:

// این مثال کد نحوه اضافه کردن شناسه مشتری و مخفی را در کد نشان می دهد.
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 را در فضای ابری نشان می دهد.
// api را راه اندازی کنید
$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 را با استفاده از روش EditApi.save() به DOCX ذخیره کنید.

نمونه کد زیر نحوه ویرایش یک سند 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("password");

// گزینه های بار را تعریف کنید
$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 ویرایش کنید.

فایل به روز شده را دانلود کنید

نمونه کد بالا فایل ورد ویرایش شده (DOCX) را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر قابل دانلود است:

// این مثال کد نحوه دانلود فایل DOCX را از ابر نشان می دهد.
// api را راه اندازی کنید
$apiInstance = new GroupDocs\Editor\FileApi($configuration);

// درخواست دانلود فایل
$request = new GroupDocs\Editor\Model\Requests\DownloadFileRequest("edited.docx", self::$MyStorage, null);

// دریافت فایل
$response = $apiInstance->downloadFile($request);

صفحات گسترده اکسل را با استفاده از REST API در PHP اصلاح کنید

ما می توانیم محتوای یک برگه اکسل را با انجام مراحلی که قبلا ذکر شد ویرایش کنیم. با این حال، ما فقط باید مسیر فایل XLSX آپلود شده را ارائه دهیم.

نمونه کد زیر نحوه ویرایش داده های برگه اکسل را با استفاده از REST API در PHP نشان می دهد.

// این مثال کد نحوه ویرایش یک برگه اکسل را نشان می دهد
// نمونه های 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();
صفحات گسترده اکسل را با استفاده از REST API در PHP اصلاح کنید.

صفحه گسترده اکسل را با استفاده از REST API در 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 به روز کنید.

آنلاین را امتحان کنید

لطفاً ابزارهای آنلاین رایگان ویرایش اسناد زیر را که با استفاده از API بالا ایجاد شده اند، امتحان کنید.

نتیجه

در این مقاله یاد گرفتیم که چگونه:

  • ویرایش یا تغییر محتوای فایل های Word، Excel یا Text در PHP.
  • آپلود فایل DOCX در فضای ابری؛
  • فایل Word به روز شده را از ابر دانلود کنید.

علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Editor Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس بگیرید17.

همچنین ببینید