Chuyển đổi các tài liệu Word phong phú sang HTML sẵn sàng cho web là nhu cầu thường gặp đối với các ứng dụng PHP hiện đại. GroupDocs.Conversion Cloud SDK for PHP cung cấp một API mạnh mẽ giúp thực hiện các công việc nặng trong đám mây. Trong hướng dẫn này, chúng tôi sẽ trình bày cách chuyển đổi DOCX sang HTML trong PHP bằng SDK. Bạn sẽ học cách thiết lập thư viện, chạy một ví dụ mã hoàn chỉnh và thực hiện cùng một chuyển đổi bằng các lệnh cURL.

Cách Chuyển Đổi DOCX sang HTML trong PHP - Từng Bước

  1. Cài đặt SDK qua Composer: Thêm thư viện vào dự án của bạn bằng lệnh Composer chính thức.
composer require groupdocs-conversion-cloud
  1. Khởi tạo Cấu hình: Tạo một đối tượng Configuration và đặt SID Ứng dụng của bạn SID và Khóa Ứng dụng.
$config = new GroupDocs\Conversion\Cloud\Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. Cấu hình tùy chọn chuyển đổi HTML: Điều chỉnh các cài đặt như trích xuất hình ảnh và xử lý số trang.
$htmlOptions = new GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions();
$htmlOptions->setExtractImages(true);
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);
  1. Tạo Cài Đặt Chuyển Đổi: Xác định tệp nguồn, định dạng đích và đính kèm các tùy chọn HTML.
$convertSettings = new GroupDocs\Conversion\Cloud\Model\ConvertSettings();
$convertSettings->setFilePath('sample.docx');
$convertSettings->setOutputPath('output.html');
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);
  1. Thực hiện chuyển đổi: Gọi phương thức convertDocument và xử lý kết quả.
$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;
}

Để biết thêm chi tiết về mỗi lớp và phương thức, hãy tham khảo API reference.

Ví dụ mã hoàn chỉnh: Tạo HTML từ DOCX trong PHP

Ví dụ sau đây minh họa một quá trình chuyển đổi end‑to‑end đầy đủ bằng 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;
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (sample.docx, output.html) để phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Chuyển đổi tệp DOCX sang HTML bằng cURL và REST API

SDK cũng cung cấp một endpoint REST có thể được gọi bằng cURL. Dưới đây là quy trình điển hình.

  1. Lấy Access Token
    Thay thế YOUR_CLIENT_ID và YOUR_CLIENT_SECRET bằng thông tin xác thực của bạn.

    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. Tải lên tệp DOCX
    Sử dụng token từ bước trước.

    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. Bắt đầu chuyển đổi
    Yêu cầu chuyển đổi sang 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. Tải xuống HTML kết quả

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

Để xem danh sách đầy đủ các tham số, xem tài liệu API chính thức.

Cài đặt và cấu hình GroupDocs.Conversion Cloud SDK for PHP

composer require groupdocs-conversion-cloud

Tải xuống gói mới nhất từ trang phát hành. SDK yêu cầu PHP 7.4 trở lên và một tài khoản GroupDocs Cloud hoạt động với thông tin đăng nhập hợp lệ.

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 Khả năng chuyển DOCX sang HTML

  • Trích xuất hình ảnh - extractImages cho phép bạn tách các hình ảnh nhúng ra thành các tệp riêng, duy trì độ chính xác bố cục.
  • Kiểm soát số trang - preserveOriginalPageNumbers có thể tắt để tạo một luồng HTML liên tục.
  • Đầu ra HTML thuần - Thiết lập zipOutput thành false tạo ra một tệp HTML duy nhất thay vì một kho lưu trữ ZIP, đơn giản hoá quá trình xử lý tiếp theo.
  • Xử lý văn bản ẩn - showHiddenText xác định liệu nội dung ẩn có xuất hiện trong HTML cuối cùng hay không.
  • Kết xuất một trang - renderToSinglePage có thể kết hợp tất cả các trang thành một tài liệu HTML duy nhất để dễ nhúng hơn.

Tất cả các tính năng được mô tả trong tài liệu.

Kết luận

Chuyển đổi DOCX sang HTML trong PHP trở nên đơn giản với GroupDocs.Conversion Cloud SDK for PHP. Thư viện xử lý định dạng phức tạp, trích xuất hình ảnh và quản lý trang mà không cần Microsoft Office trên máy chủ. Sau khi thực hiện các bước trên, bạn có thể tích hợp chuyển đổi DOCX sang HTML vào bất kỳ quy trình làm việc nào dựa trên PHP, cho dù bạn thích gọi SDK gốc hay các yêu cầu RESTful cURL. Hãy nhớ mua giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; chi tiết giá cả có trên trang giấy phép tạm thời. Bắt đầu chuyển đổi ngay hôm nay và cung cấp nội dung phong phú, sẵn sàng cho web cho người dùng của bạn.

Câu hỏi thường gặp

  • Làm thế nào để tôi triển khai DOCX sang HTML trong PHP mà không cần cài đặt phần mềm bổ sung?
    SDK dựa trên đám mây thực hiện toàn bộ xử lý trên máy chủ GroupDocs, vì vậy bạn chỉ cần thư viện PHP và thông tin xác thực của mình.

  • Có thể chuyển đổi nhiều tệp DOCX trong một yêu cầu duy nhất không?
    API hỗ trợ chuyển đổi hàng loạt bằng cách lặp lại các tệp trong mã của bạn; mỗi lần gọi trả về kết quả HTML riêng của nó.

  • Điều gì xảy ra với các hình ảnh bên trong tệp DOCX?
    Khi bật extractImages, các hình ảnh sẽ được lưu dưới dạng các tệp riêng biệt và được tham chiếu trong HTML được tạo, cho phép bạn phục vụ chúng trực tiếp.

  • Có cách nào để tùy chỉnh bố cục HTML được tạo không?
    Bạn có thể xử lý hậu kỳ đầu ra HTML hoặc điều chỉnh các tùy chọn chuyển đổi như renderToSinglePage để ảnh hưởng đến cấu trúc.

Đọc Thêm