DOCX إلى HTML في PHP: إنشاء HTML من DOCX دليل تعليمي

تحويل مستندات Word الغنية إلى HTML جاهز للويب هو حاجة متكررة لتطبيقات PHP الحديثة. يوفر GroupDocs.Conversion Cloud SDK for PHP واجهة برمجة تطبيقات قوية تتولى التعامل مع المعالجة الثقيلة في السحابة. في هذا البرنامج التعليمي نوضح تحويل DOCX إلى HTML في PHP باستخدام SDK. ستتعلم كيفية إعداد المكتبة، تشغيل مثال شفرة كامل، وإجراء نفس التحويل باستخدام استدعاءات cURL.

كيفية تحويل DOCX إلى HTML في PHP - خطوة بخطوة

1. تثبيت SDK عبر Composer: أضف المكتبة إلى مشروعك باستخدام أمر Composer الرسمي.

composer require groupdocs-conversion-cloud

2. تهيئة التكوين: إنشاء كائن Configuration وتعيين SID التطبيق ومفتاح التطبيق الخاص بك.

$config = new GroupDocs\Conversion\Cloud\Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

3. تكوين خيارات تحويل HTML: تعديل الإعدادات مثل استخراج الصور ومعالجة أرقام الصفحات.

$htmlOptions = new GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions();
$htmlOptions->setExtractImages(true);
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);

4. إنشاء إعدادات التحويل: حدد ملف المصدر، تنسيق الهدف، وأرفق خيارات HTML.

$convertSettings = new GroupDocs\Conversion\Cloud\Model\ConvertSettings();
$convertSettings->setFilePath('sample.docx');
$convertSettings->setOutputPath('output.html');
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);

5. تنفيذ التحويل: استدعِ طريقة convertDocument وتعامل مع النتيجة.

$convertApi = new GroupDocs\Conversion\Cloud\Api\ConvertApi($config);
try {
    $result = $convertApi->convertDocument($convertSettings);
    echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}

لمزيد من التفاصيل حول كل فئة وطريقة، راجع مرجع API.

مثال كامل للكود: إنشاء HTML من DOCX في PHP

المثال التالي يوضح تحويلًا كاملًا من البداية إلى النهاية باستخدام SDK.

<?php
require __DIR__ . '/vendor/autoload.php';

use GroupDocs\Conversion\Cloud\Configuration;
use GroupDocs\Conversion\Cloud\Api\ConvertApi;
use GroupDocs\Conversion\Cloud\Model\ConvertSettings;
use GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions;

$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

$convertApi = new ConvertApi($config);

$inputFilePath  = 'sample.docx';
$outputFilePath = 'output.html';

$htmlOptions = new HtmlConvertOptions();
$htmlOptions->setExtractImages(true);               // extract images to separate files
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);                  // generate plain HTML, not a zip archive
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);

$convertSettings = new ConvertSettings();
$convertSettings->setFilePath($inputFilePath);
$convertSettings->setOutputPath($outputFilePath);
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);

try {
    $result = $convertApi->convertDocument($convertSettings);
    echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}

ملاحظة: يوضح مثال الكود هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (sample.docx, output.html) لتطابق مواقع الملفات الفعلية لديك، وتحقق من تثبيت جميع الاعتمادات المطلوبة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحويل ملفات DOCX إلى HTML باستخدام cURL وواجهة برمجة التطبيقات REST API

يوفر SDK أيضًا نقطة نهاية REST يمكن استدعاؤها باستخدام cURL. أدناه هو سير العمل النموذجي.

1. الحصول على رمز وصول
   استبدل YOUR_CLIENT_ID و YOUR_CLIENT_SECRET ببيانات الاعتماد الخاصة بك.

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. رفع ملف DOCX
   استخدم الرمز المميز من الخطوة السابقة.

   curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/storage/file/sample.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@sample.docx"
   

3. بدء التحويل
   اطلب تحويل الملف إلى HTML.

   curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{
              "filePath": "sample.docx",
              "outputPath": "output.html",
              "format": "html",
              "options": {
                  "extractImages": true,
                  "zipOutput": false
              }
            }'
   

4. تنزيل ملف HTML الناتج

   curl -X GET "https://api.groupdocs.cloud/v2.0/conversion/storage/file/output.html" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.html
   

للحصول على قائمة كاملة بالمعلمات، راجع وثائق API الرسمية.

تثبيت وتكوين GroupDocs.Conversion Cloud SDK لـ PHP

composer require groupdocs-conversion-cloud

قم بتنزيل أحدث حزمة من صفحة الإصدار. يتطلب SDK PHP 7.4 أو أحدث وحسابًا نشطًا في GroupDocs Cloud مع بيانات اعتماد صالحة.

require __DIR__ . '/vendor/autoload.php';

use GroupDocs\Conversion\Cloud\Configuration;

$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');   // obtain from your GroupDocs Cloud dashboard
$config->setAppKey('YOUR_APP_KEY');

GroupDocs.Conversion Cloud SDK for PHP الإمكانات لتحويل DOCX إلى HTML

• استخراج الصور - extractImages يتيح لك سحب الصور المضمنة إلى ملفات منفصلة، مع الحفاظ على دقة التخطيط.
• التحكم في أرقام الصفحات - يمكن تعطيل preserveOriginalPageNumbers لإنتاج تدفق HTML مستمر.
• إخراج HTML عادي - ضبط zipOutput على false يولد ملف HTML واحد بدلاً من أرشيف ZIP ، مما يبسط المعالجة اللاحقة.
• معالجة النص المخفي - showHiddenText يحدد ما إذا كان المحتوى المخفي يظهر في HTML النهائي.
• عرض صفحة واحدة - renderToSinglePage يمكنه دمج جميع الصفحات في مستند HTML واحد لتسهيل الإدراج.

جميع الميزات موصوفة في التوثيق.

الخلاصة

تحويل DOCX إلى HTML في PHP يصبح بسيطًا مع GroupDocs.Conversion Cloud SDK for PHP. تتعامل المكتبة مع التنسيق المعقد، واستخراج الصور، وإدارة الصفحات دون الحاجة إلى Microsoft Office على الخادم. بعد اتباع الخطوات المذكورة أعلاه، يمكنك دمج تحويل DOCX إلى HTML في أي سير عمل يعتمد على PHP، سواء كنت تفضل استدعاءات SDK الأصلية أو طلبات cURL RESTful. تذكر الحصول على ترخيص مناسب للاستخدام في الإنتاج؛ تفاصيل الأسعار متاحة على صفحة الترخيص المؤقت. ابدأ التحويل اليوم وقدم محتوى غنيًا وجاهزًا للويب لمستخدميك.

الأسئلة الشائعة

• كيف يمكنني تنفيذ تحويل DOCX إلى HTML في PHP دون تثبيت برامج إضافية؟
  يقوم SDK السحابي بمعالجة جميع العمليات على خوادم GroupDocs، لذا كل ما تحتاجه هو مكتبة PHP وبيانات الاعتماد الخاصة بك.

• هل يمكنني تحويل ملفات DOCX متعددة في طلب واحد؟
  يدعم API التحويل على دفعات عن طريق تكرار الملفات في الكود الخاص بك؛ كل استدعاء يُعيد نتيجته الخاصة بصيغة HTML.

• ماذا يحدث للصور داخل ملف DOCX؟
  مع تمكين extractImages، يتم حفظ الصور كملفات منفصلة ويتم الإشارة إليها في HTML المُولَّد، مما يتيح لك تقديمها مباشرة.

• هل هناك طريقة لتخصيص تخطيط HTML المُولد؟
  يمكنك معالجة مخرجات HTML بعد الإنشاء أو تعديل خيارات التحويل مثل renderToSinglePage للتأثير على الهيكل.

اقرأ المزيد

• دليل شامل لتحويل JSON إلى HTML باستخدام PHP
• دليل خطوة بخطوة لتحويل HTML إلى XLSX باستخدام PHP
• دليل خطوة بخطوة لتحويل HTML إلى DOCX باستخدام Node.JS