wkhtmltopdf - на бір з двох утиліт командного рядка для рендеринга HTML-файлів або веб-сторінок з використанням движка WebKit:
/usr/local/bin/wkhtmltopdf-amd64
/usr/local/bin/wkhtmltopdf
/usr/local/bin/wkhtmltoimage
Утиліти доступні на хостингу за замовчуванням. У прикладах нижче для утиліти wkhtmltopdf використовується версія 0.12. Щоб скористатися версією 0.10, просто замініть в команді на зву утиліти з wkhtmltopdf
на wkhtmltopdf-amd64
.
Перегляд короткої документації:
wkhtmltopdf -h
wkhtmltoimage -h
Перегляд докладної документації:
wkhtmltopdf -H
wkhtmltoimage -H
Формат запуску:
wkhtmltopdf <URL або шлях до вихідного HTML-файлу> <шлях і ім'я вихідного PDF-файлу>
wkhtmltoimage <URL або шлях до вихідного HTML-файлу> <шлях і ім'я вихідного файлу зображення>
Простий приклад перетворення веб-сторінки:
wkhtmltopdf http://google.com google.pdf
Або:
/usr/local/bin/wkhtmltopdf http://google.com google.pdf
wkhtmltoimage http://google.com google.png
Або:
/usr/local/bin/wkhtmltoimage http://google.com google.png
Простий приклад перетворення HTML-документа:
wkhtmltopdf /home/example/шлях/до/файлу/document.html document.pdf
Або:
/usr/local/bin/wkhtmltopdf /home/example/шлях/до/файлу/document.html document.pdf
Де example
це на зва хостинг-аккаунта.
wkhtmltoimage /home/example/шлях/до/файлу/document.html document.png
Або:
/usr/local/bin/wkhtmltoimage /home/example/шлях/до/файлу/document.html document.png
Де example
це на зва хостинг-аккаунта.
При формуванні PDF-документа можна додавати хедер і футер з окремих HTML-файлів:
wkhtmltopdf --header-html <шлях до HTML-хедер> --footer-html <шлях до HTML-футер> <шлях до вихідного HTML-файлу> <шлях і ім'я вихідного PDF-файлу>
При необхідності для PDF-документів можна задавати відступи:
wkhtmltopdf --margin-top 25mm --margin-bottom 25 mm --margin-left 15mm --margin-right 15mm --header-html <шлях до шапки HTML> --footer-html <шлях до підвалу HTML> <шлях до вихідного файлу HTML> <шлях і ім'я вихідного файлу PDF>
Приклади інших корисних опцій для wkhtmltopdf:
–encoding windows-1251
- явне вказівку кодування вихідного HTML-файлу.–page-size A4
- формат сторінки вихідного PDF-файлу.–orientation Landscape
- орієнтація сторінки вихідного PDF-файлу.Використовувати утиліти з PHP можна за допомогою функції exec.