Шаги конвертации HTML в XLSX в PHP

1. Создать клиент Conversion API - Инициализировать класс ConversionApi с вашими учетными данными клиента.
   • Пример: new \GroupDocs\Conversion\ConversionApi($config);
   • См. API Reference для деталей класса.
2. Загрузить исходный HTML‑файл - Использовать эндпоинт UploadFile для отправки HTML‑документа в хранилище GroupDocs.
3. Настроить параметры конвертации - Установить выходной формат XLSX и при необходимости скорректировать размер страницы, имя листа или настройки извлечения данных.
4. Выполнить конвертацию - Вызвать ConvertDocument с идентификатором исходного файла и настроенными параметрами.
5. Скачать результат XLSX - Получить сгенерированный файл по URL ответа или из места хранения.

Конвертация HTML в XLSX с использованием GroupDocs — полный пример кода

Следующий пример демонстрирует полный процесс конвертации от аутентификации до загрузки файла.

В этом примере демонстрируется, как преобразовать файл HTML в XLSX с использованием GroupDocs.Conversion Cloud SDK for PHP.

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

use GroupDocs\Conversion\Configuration;
use GroupDocs\Conversion\Api\ConversionApi;
use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

// Replace with your actual credentials
$clientId = 'YOUR_CLIENT_ID';
$clientSecret = 'YOUR_CLIENT_SECRET';

// Configure the SDK
$config = new Configuration();
$config->setAppSid($clientId);
$config->setAppKey($clientSecret);

// Create API instance
$apiInstance = new ConversionApi($config);

// Paths to local files (can be absolute or relative)
$sourcePath = 'sample.html';
$targetPath = 'output.xlsx';

// Prepare conversion request
$request = new ConvertDocumentRequest(
    $sourcePath,          // Path to the source HTML file
    'XLSX',               // Desired output format
    null,                 // Optional conversion options (null for defaults)
    $targetPath           // Path where the XLSX will be saved
);

try {
    // Perform conversion
    $apiInstance->convertDocument($request);
    echo "Conversion successful. XLSX saved to {$targetPath}\n";
} catch (Exception $e) {
    echo 'Conversion failed: ', $e->getMessage(), "\n";
}
?>

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили пути к файлам (sample.html, output.xlsx), проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с службой поддержки для получения помощи.

Облачная конвертация HTML в XLSX через REST API с помощью cURL

Вы также можете выполнить конвертацию напрямую через REST‑вызовы. Ниже приведены необходимые команды cURL.

Сначала получите токен доступа, используя учетные данные клиента.

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

Загрузите HTML‑файл в конечную точку хранилища.

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

Запросите конвертацию в XLSX.

curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "inputPath": "sample.html",
           "outputPath": "output.xlsx",
           "outputFormat": "XLSX"
         }'

Скачайте преобразованный файл.

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/download?path=output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Для получения более подробной информации о параметрах запроса см. официальную документацию API.

Установка и настройка в PHP

1. Установите SDK через Composer:

   composer require groupdocs-conversion-cloud
   

2. Проверьте установку, проверив каталог vendor.
3. Получите ваш Client ID и Client Secret в портале GroupDocs.
4. (Опционально) Скачайте последнюю версию пакета вручную по ссылке Download URL.
5. Убедитесь, что ваша версия PHP соответствует требованиям SDK (PHP 7.4+).

Руководство по конвертации HTML в XLSX в PHP с GroupDocs.Conversion

GroupDocs.Conversion Cloud предоставляет единый API, который абстрагирует логику, зависящую от формата. Когда вы отправляете HTML‑документ, сервис анализирует разметку, рендерит таблицы, стили и встроенные изображения, а затем преобразует их в листы Excel. Такой подход устраняет необходимость в сторонних парсерах или ручной генерации CSV, предоставляя точное представление оригинального HTML‑макета в виде таблицы.

GroupDocs.Conversion Features

• Multiple input formats - HTML, DOCX, PDF, и др.
• High‑fidelity rendering - Сохраняет стили CSS, объединённые ячейки и изображения.
• Scalable cloud processing - Обрабатывает большие файлы без ограничений локальных ресурсов.
• Secure data handling - Весь трафик зашифрован, а файлы хранятся временно.
• Extensible options - Позволяет управлять именем листа, шириной столбцов и режимами извлечения данных.

Оптимизация производительности при конвертации HTML в XLSX в PHP

При конвертации больших HTML‑отчетов учитывайте следующие рекомендации:

Рекомендации

• Разбейте большой HTML на секции и конвертируйте их последовательно.
• Включите потоковую передачу, установив useStreaming=true в параметрах запроса.
• Повторно используйте клиент API при множественных конверсиях, чтобы избежать повторных затрат на аутентификацию.

Эти практики улучшают производительность преобразования HTML в XLSX в PHP и снижают нагрузку на память вашего сервера.

Лучшие практики безопасности при конвертации HTML в XLSX

• Безопасное хранение учетных данных - Используйте переменные окружения или менеджер секретов вместо их жесткого кодирования.
• Проверка входного HTML - Удаляйте потенциально опасные скрипты или внешние ресурсы перед загрузкой.
• Используйте HTTPS - Все API‑конечные точки требуют TLS 1.2 или выше.
• Применяйте принцип наименьших привилегий - Предоставляйте SDK только те области хранения, которые ему необходимы.
• Мониторинг использования - Включите аудит‑логи в портале GroupDocs для отслеживания активности конвертации.

Заключение

Преобразование HTML в XLSX в PHP становится простым с помощью GroupDocs.Conversion Cloud SDK for PHP. Следуя шагам, примерам кода и рекомендациям по безопасности, представленным здесь, вы можете надёжно генерировать файлы Excel из насыщенного HTML‑контента, независимо от того, выполняете ли вы процесс локально или в облаке. Для производственных развертываний получите соответствующую лицензию через страницу временной лицензии или изучите полные варианты ценообразования на сайте продукта.

Часто задаваемые вопросы

Как обрабатывать большие HTML‑файлы при конвертации HTML в XLSX в PHP?
Разбейте документ на более мелкие фрагменты, используйте опцию потоковой передачи и обрабатывайте каждый фрагмент последовательно. Флаг useStreaming SDK уменьшает использование памяти и ускоряет конвертацию.

Какой рекомендуемый способ защиты моих учетных данных API для конвертации HTML в XLSX в PHP?
Храните YOUR_CLIENT_ID и YOUR_CLIENT_SECRET в переменных окружения или в хранилище секретов и никогда не коммитьте их в систему контроля версий. SDK читает эти значения во время выполнения.

Могу ли я выполнять преобразование HTML в XLSX на Azure Functions или AWS Lambda?
Да. Облачный API работает в любой среде, способной выполнять HTTPS‑запросы, включая серверлесс‑платформы Azure и AWS. Просто подключите SDK через Composer и при необходимости настройте URL конечной точки.

Есть ли способ конвертировать HTML в XLSX без написания собственного кода парсинга?
Безусловно. Метод ConvertDocument SDK абстрагирует всю логику парсинга и сопоставления, позволяя выполнить конвертацию одним вызовом API.

Читать далее

• Пример конвертации ODS в XLSX на PHP
• Конвертация SVG в JPG без внешних инструментов на PHP
• Конвертация PDF в HTML с использованием .NET - PDF to Web Conversion