Total HTML Converter X vs wkhtmltopdf：サーバー向けの保守されている代替ツール

PDF生成パイプラインはwkhtmltopdfで動いており、長年問題なく機能してきた — そのプロジェクトがアーカイブされるまでは。リポジトリは2023年1月2日に読み取り専用となり、以降セキュリティパッチは提供されていない。内部で使われている古いWebKitエンジンは、モダンなCSS（flexbox、grid、カスタムプロパティ）を予測できない形でレンダリングする。レポートのレイアウトが崩れるようになった、あるいは本番サーバーでメンテナンスされていないバイナリを使い続ける理由がなくなったなら、サポートされた代替ツールが必要だ。Windowsでのその代替ツールがTotal HTML Converter Xである。

クイック回答：単純な静的HTMLであれば、wkhtmltopdfは今でも動作し、無料のままだ。しかしそのプロジェクトはアーカイブ済みで、セキュリティパッチは提供されず、モダンなCSSは予測できない形でレンダリングされる。Windowsサーバー上でメンテナンスされた本番運用が必要なら、Total HTML Converter Xは最新のCSSレンダリング、ライブURLとファイルのPDF・DOC・TIFF・JPEGへの変換、サイレントなコマンドライン、そしてASP、PHP、.NETから呼び出せるCOM/ActiveX APIを備えている。

Total HTML Converter X vs wkhtmltopdf：スペック比較

wkhtmltopdfが優れていた点

正当に評価すべき点はある — wkhtmltopdfはその地位に見合う実績を積んできた。無料でオープンソースであり、たった1つのコマンドで実行でき、シェルアウトできる言語であればどれにでもスクリプトとして組み込める。10年もの間、「この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を出力先にでき、アーカイブ、サムネイル生成、データ抽出の作業を1つのツールでカバーできる。
• サーバーAPI。コマンドラインに加えてActiveX/COMインターフェースを公開しているため、ページごとにプロセスを起動することなくASP、PHP、.NET、Python、Ruby、Javaに組み込める。
• ヘッドレスサーバー向けに作られている。GUIなし、ダイアログなし、ポップアップなしのサイレント実行で、IIS、Docker、Citrix、Wine上でテスト済みだ。PDF出力はデジタル署名、AES暗号化、権限単位のフラグ設定に対応する。

Windowsでwkhtmltopdfの代わりに何を使うべきか？

Windowsサーバーであれば、Total HTML Converter Xが最も近い代替となる — 既存のスクリプトで使っているコマンドライン形式のワークフローをそのまま維持しつつ、メンテナンスされたレンダリングエンジンを追加し、出力をPDF以外にも広げられる。CLIの呼び出しを1つ置き換えるだけで、署名、暗号化、追加フォーマットが手に入る。LinuxやmacOSで運用している場合、Total HTML Converter Xは役に立たない — Windows専用だからだ — そうした環境でメンテナンスされている選択肢は、直接またはラッパー経由で使うヘッドレスのChromeやChromiumになる。

ASPやPHPからHTMLをPDFに変換するには？

方法は2つある — コマンドラインのバイナリをシェルアウトで呼び出すか、ActiveX/COMオブジェクトをプロセス内から呼び出すかだ。シェルアウトはwkhtmltopdfのパイプラインからの変更が最も小さく済む方法で、実行ファイルとスイッチの構文を置き換えるだけでよい。

<?php
// Convert a local HTML file to PDF from PHP on Windows
exec('HtmlConverter.exe C:\www\invoice.html C:\pdf\invoice.pdf -c pdf -log C:\log\html.txt');
?>

-c pdfスイッチで出力形式を指定する。複数のファイルを1つのPDFにまとめるには-combineを追加し、結果に署名するには-pfxfileと-pfxpassを使う。バイナリはサイレントで実行されるため、ダイアログがWebリクエストをブロックすることはない。クラシックASPや.NETからは、代わりに同梱のActiveX/COMオブジェクトを作成し、ページごとに子プロセスを起動することなく同じ変換をプロセス内で実行できる。

コマンドラインからライブURLをPDFに変換できるか？

できる — ファイルパスの代わりにURLをコンバーターに渡せば、実際のページを取得してレンダリングする：

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

これはwkhtmltopdfのURLからPDFへという呼び出しをそのまま置き換えるものだ。同じパターンは画像出力にも使え、PDFを書き出す代わりに-c jpgや-c tiffでページをラスタライズできる。ワイルドカードマスクや-listテキストファイルを使えば、1つのコマンドでURLやローカルファイルのバッチ全体を処理できる。

どちらを選ぶべきか

• 単純で変更のないHTMLテンプレートで予算がない — wkhtmltopdfなら無料でこなせる。
• LinuxまたはmacOSのパイプライン — Total HTML Converter XはWindows専用のため、代わりにヘッドレスChromeを検討する。
• Windowsサーバー、モダンなCSS、またはメンテナンスされていないバイナリを廃止すべきというコンプライアンス上の圧力 — Total HTML Converter X。
• PDF以外の出力 — アーカイブやサムネイル用のDOC、TIFF、JPG — Total HTML Converter X。
• サーバーパイプラインからの署名付きまたは暗号化されたPDF — Total HTML Converter X。
• ページごとにプロセスを起動しない、ASP、PHP、.NETからのプロセス内統合 — ActiveX/COM経由のTotal HTML Converter X。

Total HTML Converter Xはサーバー単位のライセンスで$750からとなっており、30日間の試用版には制限が一切ない完全な機能が備わっている — 現在のパイプラインで最もレンダリングが崩れているページを対象に試して、出力されたPDFを見比べてほしい。単発の作業でGUIが必要な場合は、同じエンジンをデスクトップ版のTotal HTML Converterとしても利用できる。

Total HTML Converter X vs wkhtmltopdf — よくある質問 ▼