Total HTML Converter X vs wkhtmltopdf: поддерживаемая альтернатива для серверов

Ваш конвейер генерации PDF работает на wkhtmltopdf, и годами это работало — пока проект не заархивировали. 2 января 2023 года репозиторий стал доступен только для чтения: новых патчей безопасности больше не будет, а устаревший движок WebKit внутри непредсказуемо отображает современный CSS (flexbox, grid, custom properties). Если отчёты теперь выходят с перекошенной вёрсткой или вы больше не можете обосновать использование неподдерживаемого бинарника на боевом сервере, нужна поддерживаемая замена. Для Windows это Total HTML Converter X.

Быстрый ответ: Для простого статического HTML wkhtmltopdf по-прежнему работает и остаётся бесплатным, но проект заархивирован — патчей безопасности не будет, а современный CSS отображается непредсказуемо. Для поддерживаемого продакшена на Windows-серверах Total HTML Converter X даёт актуальный рендеринг CSS, конвертацию живых URL и файлов в PDF, DOC, TIFF и JPEG, тихую командную строку и COM/ActiveX API, вызываемый из ASP, PHP и .NET.

Total HTML Converter X vs wkhtmltopdf: факты рядом

В чём хорош wkhtmltopdf

Отдадим должное: wkhtmltopdf заслужил своё место. Он бесплатный и с открытым исходным кодом, запускается одной командой и легко встраивается в сценарии на любом языке, который умеет вызывать внешние процессы. Десять лет он был стандартным ответом на вопрос как отрендерить этот HTML в PDF на сервере, и его база пользователей огромна — бесчисленные конвейеры выставления счетов, отчётности и экспорта до сих пор вызывают его каждый день. Для простого статического HTML — таблицы, стилизованной квитанции, обычного отчёта — он всё ещё выдаёт приличный PDF бесплатно.

Если ваши шаблоны просты и не меняются, а вы готовы использовать заархивированный бинарник, wkhtmltopdf не сломан. Проблема во всём, что изменилось после того, как разработка остановилась: новый CSS, новый TLS, новые требования к безопасности.

В чём выигрывает Total HTML Converter X

• Он поддерживается. Заархивированный проект не получает исправлений безопасности. Total HTML Converter X — поддерживаемый коммерческий продукт, поэтому ошибка рендеринга или уязвимость в зависимости будет исправлена, а не останется навсегда.
• Рендеринг с учётом CSS. Распознаёт все теги HTML и стили CSS 1/2, учитывает разрывы страниц и автоматически подгоняет широкие HTML-таблицы под страницу. Для страниц, завязанных на современную вёрстку или скрипты, включите движок рендеринга Chrome — и результат совпадёт с тем, что показывает настоящий браузер.
• Конвертация живых URL. Передайте путь к файлу или удалённый URL — программа сама загрузит и отрендерит живую страницу, без отдельного шага скачивания, встроенного в ваш скрипт.
• Не только PDF. Тот же вызов может выдать DOC, RTF, XLS, TIFF, JPG, PNG или TXT, поэтому один инструмент закрывает задачи архивирования, создания миниатюр и извлечения данных.
• Серверный API. Помимо командной строки, доступен интерфейс ActiveX/COM, поэтому продукт встраивается в ASP, PHP, .NET, Python, Ruby или Java без запуска отдельного процесса на каждую страницу.
• Создан для headless-серверов. Работает тихо — без GUI, без диалогов, без всплывающих окон — и протестирован на IIS, Docker, Citrix и Wine. PDF на выходе поддерживает цифровые подписи, шифрование AES и флаги разрешений.

Что использовать вместо wkhtmltopdf на Windows?

На Windows-сервере Total HTML Converter X — ближайшая прямая замена: сохраняет привычный сценарий работы через командную строку, добавляет поддерживаемый движок рендеринга и расширяет вывод за пределы PDF. Вы меняете один вызов CLI на другой и получаете подписание, шифрование и дополнительные форматы. Если конвейер работает на Linux или macOS, Total HTML Converter X не поможет — продукт только для Windows — и поддерживаемый путь там — headless Chrome или Chromium, напрямую или через обёртку.

Как конвертировать HTML в PDF из ASP или PHP?

Два способа: вызвать бинарник командной строки как внешний процесс или обратиться к объекту ActiveX/COM прямо из процесса приложения. Вызов внешнего процесса — минимальное изменение по сравнению с конвейером на wkhtmltopdf: вы меняете исполняемый файл и синтаксис параметров:

<?php
// Конвертация локального HTML-файла в PDF из PHP на Windows
exec('HtmlConverter.exe C:\www\invoice.html C:\pdf\invoice.pdf -c pdf -log C:\log\html.txt');
?>

Параметр -c pdf задаёт целевой формат; добавьте -combine, чтобы объединить несколько файлов в один PDF, или -pfxfile и -pfxpass, чтобы подписать результат. Поскольку бинарник работает тихо, ни один диалог не блокирует веб-запрос. В классическом ASP или .NET вместо этого можно создать встроенный объект ActiveX/COM и выполнять ту же конвертацию прямо из процесса приложения, не запуская дочерний процесс для каждой страницы.

Можно ли конвертировать живые URL в PDF из командной строки?

Да — передайте конвертеру URL вместо пути к файлу, и он загрузит и отрендерит живую страницу:

HtmlConverter.exe http://www.example.com C:\pdf\page.pdf -c pdf -log C:\log\html.txt

Это прямая замена вызову URL to PDF в wkhtmltopdf. Тот же шаблон подходит для изображений — используйте -c jpg или -c tiff, чтобы растрировать страницу вместо записи PDF. Маска с подстановочными знаками или текстовый файл -list позволяют одной командой обработать целый пакет URL или локальных файлов.

Когда что выбирать

• Простые, неизменные HTML-шаблоны и нет бюджета — wkhtmltopdf по-прежнему справляется, бесплатно.
• Конвейер на Linux или macOS — Total HTML Converter X доступен только для Windows; рассмотрите headless Chrome.
• Windows-сервер, современный CSS или требования комплаенса вывести из эксплуатации неподдерживаемый бинарник — Total HTML Converter X.
• Вывод помимо PDF — DOC, TIFF или JPG для архивирования и миниатюр — Total HTML Converter X.
• Подписанные или зашифрованные PDF из серверного конвейера — Total HTML Converter X.
• Интеграция прямо в процесс приложения из ASP, PHP или .NET без отдельного процесса на каждую страницу — Total HTML Converter X через ActiveX/COM.

Total HTML Converter X лицензируется на один сервер, от $750, а 30-дневная пробная версия полностью функциональна и без ограничений — запустите её на страницах, которые ваш текущий конвейер рендерит хуже всего, и сравните PDF бок о бок. Тот же движок поставляется и как настольный Total HTML Converter для разовых задач, когда нужен графический интерфейс.

Вопросы и ответы: Total HTML Converter X vs wkhtmltopdf ▼