Конвертація HTML у DOCX у PHP

Конвертування документів HTML у формат Word є частою вимогою при створенні звітів, рахунків‑фактур або динамічного контенту для кінцевих користувачів. Aspose.HTML Cloud SDK for PHP — потужна бібліотека, яка спрощує конвертацію HTML у DOCX на стороні сервера. Цей посібник проведе вас через весь процес, від встановлення та безпечної обробки HTML до повного, готового до продакшну прикладу коду та рекомендацій щодо кращих практик.

Конвертація HTML у DOCX за допомогою PHP у 5 кроків

Встановіть бібліотеку Aspose.HTML Cloud: використайте Composer, щоб додати пакет у ваш проєкт.

composer require aspose-html-cloud

Аутентифікуйтеся за допомогою ваших облікових даних Aspose Cloud: створіть об’єкт Configuration з вашим client ID та secret, потім отримайте токен доступу.

use Aspose\HTML\Configuration;

$config = new Configuration();
$config->setClientId('YOUR_CLIENT_ID');
$config->setClientSecret('YOUR_CLIENT_SECRET');

Підготуйте HTML‑вміст: завантажте вихідний HTML з файлу або рядка, і за потреби очистіть його, щоб уникнути XSS.

use Aspose\HTML\Conversion\ConversionApi;

$htmlPath = __DIR__ . '/sample.html';
$htmlContent = file_get_contents($htmlPath);
// Example sanitization (replace with a robust library for production)
$htmlContent = strip_tags($htmlContent, '<p><a><img><style><div>');

Конвертуйте у DOCX: викличте endpoint конвертації з потрібним форматом виводу. Основний метод — convertDocument.

$apiInstance = new ConversionApi($config);
$convertRequest = new \Aspose\HTML\Model\ConvertDocumentRequest(
    $htmlContent,
    'HTML',
    'DOCX'
);
$docxResult = $apiInstance->convertDocument($convertRequest);
file_put_contents('output.docx', $docxResult);

Отримайте результат та очистіть ресурси: конвертація повертає бінарний потік, який ви можете зберегти як файл DOCX. Переконайтеся, що обробляєте помилки та звільняєте ресурси.

if ($docxResult) {
    echo "Conversion successful. DOCX saved as output.docx";
} else {
    echo "Conversion failed.";
}

Вищенаведені кроки демонструють просте перетворення HTML у DOCX у PHP, а також показують, де можна додати перевірки безпеки та налаштування продуктивності.

Конвертація HTML у DOCX у PHP за допомогою Aspose.HTML - Повний приклад коду

Наступний приклад об’єднує всі частини в один готовий до виконання скрипт.

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

use Aspose\HTML\Configuration;
use Aspose\HTML\Conversion\ConversionApi;
use Aspose\HTML\Model\ConvertDocumentRequest;

// 1. Configure client credentials
$config = new Configuration();
$config->setClientId('YOUR_CLIENT_ID');
$config->setClientSecret('YOUR_CLIENT_SECRET');

// 2. Load and optionally sanitize HTML
$htmlPath = __DIR__ . '/sample.html';
$htmlContent = file_get_contents($htmlPath);
$htmlContent = strip_tags($htmlContent, '<p><a><img><style><div>');

// 3. Initialize the conversion API
$apiInstance = new ConversionApi($config);

// 4. Create conversion request (HTML -> DOCX)
$convertRequest = new ConvertDocumentRequest(
    $htmlContent,   // source HTML string
    'HTML',         // source format
    'DOCX'          // target format
);

// 5. Execute conversion
try {
    $docxStream = $apiInstance->convertDocument($convertRequest);
    file_put_contents('output.docx', $docxStream);
    echo "HTML successfully converted to DOCX. File saved as output.docx";
} catch (Exception $e) {
    echo 'Conversion error: ', $e->getMessage();
}

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили шляхи до файлів (sample.html, output.docx), перевірили, що всі необхідні залежності встановлені правильно, і ретельно протестували у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або до команди підтримки за допомогою.

Генерування документів Word з HTML за допомогою REST API та cURL

Ви також можете виконати конвертацію без написання коду PHP, викликавши безпосередньо REST‑кінцеві точки Aspose.HTML Cloud.

Отримати токен доступу

curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

Завантажити вихідний HTML файл

curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/sample.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T sample.html

Запитати конвертацію у DOCX

curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"sample.html","outputPath":"output.docx"}'

Завантажити отриманий файл DOCX

curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.docx

Ці команди cURL ілюструють повний процес конвертації від автентифікації до отримання файлу. Для отримання додаткових відомостей перегляньте офіційну документацію API.

Aspose.HTML Cloud SDK for PHP - Передумови та налаштування

Перш ніж почати кодування, переконайтеся, що ваше середовище відповідає наступним вимогам:

PHP 7.4 або пізніше
Composer встановлений глобально
Активний обліковий запис Aspose Cloud з дійсними обліковими даними клієнта

Встановіть бібліотеку та завантажте останній пакет:

composer require aspose-html-cloud

Ви також можете клонувати вихідний код з GitHub, якщо бажаєте:

git clone https://github.com/aspose-html-cloud/aspose-html-cloud-php.git

Після встановлення налаштуйте ваш client ID та secret, як показано у розділі кроків. Для повного списку параметрів конфігурації зверніться до документації.

Aspose.HTML Cloud SDK for PHP Можливості для створення DOCX високої якості

Точне відображення CSS – Бібліотека аналізує зовнішні та вбудовані CSS, зберігаючи макет, шрифти та кольори у згенерованому DOCX.
Підтримка вбудованих шрифтів – Використовуйте правила @font-face для вбудовування користувацьких шрифтів, забезпечуючи ідентичний вигляд Word‑документа на різних платформах.
Безпечна обробка вхідних даних – Вбудовані гачки санітизації дозволяють видаляти небезпечні теги та атрибути, зменшуючи ризики XSS під час конвертації.
Керування продуктивністю – Параметри, такі як maxImageResolution та disableExternalResources, дозволяють точно налаштувати швидкість щодо точності.
Пакетна обробка – API приймає колекції HTML‑файлів, забезпечуючи високопродуктивні конвертаційні конвеєри.

Ці функції роблять бібліотеку ідеальною для серверної генерації документів, де якість і безпека мають першорядне значення.

Висновок

Перетворення HTML у DOCX у PHP тепер стало спрощеним процесом завдяки потужним можливостям Aspose.HTML Cloud SDK for PHP. Дотримуючись кроків, застосовуючи кращі практики безпеки та використовуючи параметри продуктивності бібліотеки, ви можете надійно створювати Word‑документи, які зберігають оригінальний вигляд HTML. Пам’ятайте, що потрібно отримати належну ліцензію для використання у продакшн‑середовищі; деталі цін доступні на сторінці продукту, а тимчасову ліцензію для тестування можна отримати зі сторінки тимчасової ліцензії. Завдяки цим знанням ви готові інтегрувати високоякісне перетворення HTML у DOCX у ваші PHP‑застосунки.

Питання та відповіді

Який найпростіший спосіб розпочати конвертацію HTML у DOCX у PHP?
Використайте однорядковий виклик convertDocument з бібліотеки Aspose.HTML Cloud після встановлення її через Composer. Приклад у цьому посібнику показує мінімальний необхідний код.
Як я можу захистити свій застосунок від зловмисного HTML під час конвертації?
Очистіть вхідні дані за допомогою бібліотеки, такої як HTMLPurifier, або використайте вбудовані хуки санітизації, надані бібліотекою, перед відправкою вмісту до API конвертації.
Чи підтримує бібліотека конвертацію HTML, що містить зовнішні зображення?
Так. За замовчуванням зовнішні ресурси завантажуються та вбудовуються. Ви можете вимкнути цю поведінку за допомогою параметра disableExternalResources, якщо хочете зменшити розмір DOCX.
Де я можу знайти більш розширені параметри конфігурації для виводу DOCX?
Усі налаштування конвертації задокументовані в офіційній документації, включаючи параметри розміру сторінки, полів та вбудовування шрифтів.

Конвертація HTML у DOCX за допомогою PHP у 5 кроків#

Конвертація HTML у DOCX у PHP за допомогою Aspose.HTML - Повний приклад коду#

Генерування документів Word з HTML за допомогою REST API та cURL#

Aspose.HTML Cloud SDK for PHP - Передумови та налаштування#

Aspose.HTML Cloud SDK for PHP Можливості для створення DOCX високої якості#

Висновок#

Питання та відповіді#

Читати далі#