يمكننا بسهولة عرض ملفات DOC أو DOCX في صفحات ويب HTML برمجيًا على السحابة. يمكن أن يكون مفيدًا في عرض مستندات Word في أي متصفح دون مشاركة الملفات الأصلية. في هذه المقالة ، سنتعلم كيفية عرض مستند Word في صفحة HTML باستخدام واجهة برمجة تطبيقات REST في PHP.
سيتم تناول الموضوعات التالية في هذه المقالة:
- Word to HTML Viewer REST API و PHP SDK
- عرض مستند Word في صفحة HTML باستخدام REST API في PHP
- قم بتضمين مستند Word في صفحة HTML الموجودة
- عرض مستند Word بتنسيق HTML مع علامة مائية باستخدام PHP
Word to HTML Viewer REST API و PHP SDK
لتقديم مستندات Word بتنسيق HTML ، سنستخدم PHP SDK of GroupDocs.Viewer Cloud API. يسمح بتقديم وعرض تنسيقات ملفات الصور والوثائق المدعومة برمجيًا. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:
composer require groupdocscloud/groupdocs-viewer-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\Viewer\Configuration();
// ضبط التكوينات
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);
عرض مستند Word في صفحة HTML باستخدام REST API في PHP
يمكننا عرض محتوى مستند Word بتنسيق HTML باتباع الخطوات البسيطة الواردة أدناه:
- تحميل ملف DOCX إلى السحابة
- عرض مستند Word في صفحة HTML
- تنزيل الملف المقدم
قم بتحميل المستند
أولاً ، سنقوم بتحميل ملف DOCX إلى السحابة باستخدام نموذج الرمز الوارد أدناه:
// يوضح مثال الرمز هذا كيفية تحميل ملف DOCX إلى السحابة.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Viewer\FileApi($configuration);
// مسار ملف الإدخال
$file = "C:\\Files\\Viewer\\input.docx";
// طلب رفع الملف
$request = new GroupDocs\Viewer\Model\Requests\uploadFileRequest("input.docx", $file);
// رفع ملف
$response = $apiInstance->uploadFile($request);
نتيجة لذلك ، سيكون الملف الذي تم تحميله متاحًا في قسم الملفات من لوحة القيادة على السحابة.
عرض مستند Word في صفحة HTML باستخدام PHP
الآن ، سنقوم بعرض أو عرض محتوى مستند Word الذي تم تحميله على صفحات HTML باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل لـ ViewAPI.
- بعد ذلك ، قم بإنشاء مثيل لـ ViewOptions.
- ثم قم بتوفير مسار ملف الإدخال.
- أيضًا ، قم بتعيين ViewFormat على أنه “HTML”.
- بعد ذلك ، قم بتهيئة كائن HtmlOptions.
- بعد ذلك ، قم بتعيين خصائص مختلفة مثل IsResponsive و ForPrinting وما إلى ذلك.
- بعد ذلك ، قم بإنشاء CreateViewRequest باستخدام ViewOptions كوسيطة.
- أخيرًا ، قم بتصيير Word إلى HTML باستخدام طريقة createView().
يوضح نموذج التعليمات البرمجية التالي كيفية عرض ملف Word بتنسيق HTML باستخدام REST API في PHP.
// يوضح مثال التعليمات البرمجية هذا كيفية تحويل DOCX إلى HTML.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
// تحديد خيارات العرض
$viewOptions = new Model\ViewOptions();
// مسار ملف الإدخال
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");
$viewOptions->setFileInfo($fileInfo);
// تعيين ViewFormat
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);
// حدد خيارات HTML
$renderOptions = new Model\HtmlOptions();
// اضبطها لتكون سريعة الاستجابة
$renderOptions->setIsResponsive(true);
// تعيين للطباعة
$renderOptions->setForPrinting(true);
// تعيين خيارات التجسيد
$viewOptions->setRenderOptions($renderOptions);
// إنشاء طلب عرض
$request = new Requests\CreateViewRequest($viewOptions);
// إنشاء عرض
$response = $apiInstance->createView($request);
// منتهي
echo "HtmlViewerResponsiveLayout completed: ", count($response->getPages());
echo "\n";
عرض مستند Word في صفحة HTML باستخدام REST API في PHP.
يمكننا تخصيص عرض Word إلى HTML من خلال تطبيق الخيارات التالية:
- تقديم نطاق معين من الصفحات
// Pass specific range of page numbers to render.
// This will render all pages from starting from page 1 to 3.
$renderOptions->setStartPageNumber(1);
$renderOptions->setCountPagesToRender(3);
- تقديم الصفحات المحددة فقط
// Pass specific page numbers to render.
// This will render only page number 1 and 3.
$renderOptions->setPagesToRender([1, 3]);
- عرض الصفحات بترتيب معين
// Pass page numbers in the order you want to render them
$renderOptions->setPagesToRender([2, 1]);
- تقديم المستند مع التعليقات
$renderOptions->setRenderComments(true);
قم بتنزيل صفحات HTML
سيحفظ نموذج التعليمات البرمجية أعلاه صفحة (صفحات) HTML المعروضة على السحابة. يمكن تنزيله باستخدام نموذج التعليمات البرمجية التالي:
// يوضح مثال الكود هذا كيفية تنزيل صفحات HTML المعروضة من السحابة.
$fileApi = new GroupDocs\Viewer\FileApi($configuration);
// احصل على كل الصفحات
$pages = $response->getPages();
// احفظ الصفحات واحدة تلو الأخرى
foreach ($pages as $page)
{
// طلب إنشاء ملف تنزيل
$downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");
// تحميل الملف
$file = $fileApi->DownloadFile($downloadFileRequest);
echo "$page downloaded!";
echo "\n";
}
قم بتضمين مستند Word في صفحة HTML الموجودة
يمكننا أيضًا تضمين مستند Word في صفحة HTML موجودة باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيلات من ViewAPI و FileAPI.
- بعد ذلك ، قم بإنشاء مثيل لـ ViewOptions.
- ثم قم بتوفير مسار ملف الإدخال.
- أيضًا ، قم بتعيين ViewFormat على أنه “HTML”.
- بعد ذلك ، قم بتهيئة كائن HtmlOptions.
- بعد ذلك ، قم بتعيين خصائص مختلفة مثل IsResponsive و ForPrinting وما إلى ذلك.
- بعد ذلك ، قم بإنشاء CreateViewRequest باستخدام ViewOptions كوسيطة.
- بعد ذلك ، قم بتصيير Word إلى HTML باستخدام طريقة createView ().
- بعد ذلك ، قم بتحميل ملف HTML موجود واحصل على عناصر من علامة النص الأساسي
- بعد ذلك ، اقرأ HTML لكل صفحة وألحقه بعلامة النص الأساسي
- بعد ذلك ، احفظ HTML المحدث باستخدام طريقة saveHTML().
- أخيرًا ، احفظ ملف HTML باستخدام طريقة file \ put \ content().
يوضح نموذج التعليمات البرمجية التالي كيفية تضمين مستند Word في صفحة HTML موجودة باستخدام واجهة برمجة تطبيقات REST في PHP.
// يوضح مثال التعليمات البرمجية هذا كيفية تحويل DOCX إلى HTML.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
$fileApi = new GroupDocs\Viewer\FileApi($configuration);
// تحديد خيارات العرض
$viewOptions = new Model\ViewOptions();
// مسار ملف الإدخال
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");
$viewOptions->setFileInfo($fileInfo);
// تعيين ViewFormat
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);
// حدد خيارات HTML
$renderOptions = new Model\HtmlOptions();
// اضبطها لتكون سريعة الاستجابة
$renderOptions->setIsResponsive(true);
// تعيين للطباعة
$renderOptions->setForPrinting(true);
// تعيين خيارات التجسيد
$viewOptions->setRenderOptions($renderOptions);
// إنشاء طلب عرض
$request = new Requests\CreateViewRequest($viewOptions);
// إنشاء عرض
$response = $apiInstance->createView($request);
// تحميل ملف HTML موجود
$domDoc = new DOMDocument();
$domDoc->loadHTMLFile("C:\Files\Viewer\Sample.html");
$body = $domDoc->GetElementsByTagName('body')->item(0);
// احصل على الصفحات
$pages = $response->getPages();
// قم بتضمين جميع صفحات HTML المقدمة في علامة النص الأساسي لـ HTML الحالي
foreach ($pages as $page)
{
// طلب إنشاء ملف تنزيل
$downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");
// تنزيل الصفحة المحولة
$file = $fileApi->DownloadFile($downloadFileRequest);
// اقرأ HTML من ملف التنزيل
$html = file_get_contents($file->getRealPath());
//إضافة محتوى إلى الشظية
$fragment = $domDoc->createDocumentFragment();
$fragment->appendXML("<div>$html</div>");
// إلحاق العنصر بالنص
$body->appendChild($fragment);
}
// احفظ HTML المحدث
$output = $domDoc->saveHTML();
// حفظ الملف
file_put_contents("C:\Files\Viewer\Sample.html", $output);
قم بتضمين مستند Word في صفحة HTML موجودة.
عرض مستند Word بتنسيق HTML مع علامة مائية باستخدام PHP
يمكننا إضافة نص علامة مائية أثناء عرض مستندات Word على صفحات HTML برمجيًا باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل لـ ViewAPI.
- بعد ذلك ، قم بإنشاء مثيل لـ ViewOptions.
- ثم قم بتوفير مسار ملف الإدخال.
- أيضًا ، قم بتعيين ViewFormat على أنه “HTML”.
- بعد ذلك ، قم بإنشاء وتعيين مثيل للعلامة المائية.
- ثم قم بتعيين حجم العلامة المائية والنص.
- بعد ذلك ، قم بإنشاء CreateViewRequest باستخدام ViewOptions كوسيطة.
- أخيرًا ، اعرض Word إلى HTML باستخدام طريقة createView ().
يوضح نموذج التعليمات البرمجية التالي كيفية عرض مستند Word بتنسيق HTML مع علامة مائية باستخدام واجهة برمجة تطبيقات REST في PHP.
// يوضح مثال التعليمات البرمجية هذا كيفية عرض Word بتنسيق HTML باستخدام علامة مائية.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
// تحديد خيارات العرض
$viewOptions = new Model\ViewOptions();
// مسار ملف الإدخال
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");
$viewOptions->setFileInfo($fileInfo);
// تعيين ViewFormat
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);
// تحديد العلامة المائية
$watermark = new Model\Watermark();
$watermark->setText("This is sample text watermark!");
$watermark->setSize(100);
$watermark->setColor("Red");
$viewOptions->setWatermark($watermark);
// إنشاء طلب عرض
$request = new Requests\CreateViewRequest($viewOptions);
// إنشاء عرض
$response = $apiInstance->createView($request);
// منتهي
echo "AddWatermark completed: ", count($response->getPages());
echo "\n";
عرض مستند Word بتنسيق HTML مع علامة مائية باستخدام PHP.
جرب عبر الإنترنت
يرجى تجربة أداة عرض DOCX المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/viewer/docx
خاتمة
في هذه المقالة ، تعلمنا كيفية:
- عرض مستند Word في مستعرض صفحة ويب HTML مدعومة باستخدام PHP ؛
- تخصيص تحويل Word إلى HTML ؛
- تضمين مستند Word في صفحة ويب HTML موجودة ؛
- عرض محتوى ملف Word بتنسيق HTML مع العلامة المائية ؛
- تحميل ملف DOCX برمجيًا إلى السحابة ؛
- تنزيل ملفات HTML المقدمة من السحابة.
بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Viewer Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.