Мы используем cookie-файлы
Для оптимизации работы нашего сайта мы используем cookie-файлы. Продолжая использовать сайт, Вы соглашаетесь с использованием cookie-файлов.
Панель управления
  • Русский
  • Українська
  • UAH
  • USD
  • RUB
  • EUR
  • +38(044) 392-74-33  Киев
  • +38(057) 728-39-00  Харьков
  • +38(056) 794-38-31  Днепр
  • +38(032) 229-58-93  Львов
  • +38(048) 738-57-70  Одесса
  • +38(093) 170-15-42  Life
  • +38(067) 400-88-44  Киевстар
  • +38(095) 630-90-82  Vodafone
  • +1(888)393-24-51  USA, Toll free
  • +44(131)507-01-14  Great Britain
  • +7(499) 348-28-61  Москва

2.23.1.1. Утилиты wkhtmltopdf и wkhtmltoimage

wkhtmltopdf — набор из двух утилит командной строки для рендеринга HTML-файлов или веб-страниц с использованием движка WebKit:

  • Утилита wkhtmltopdf выполняет рендеринг в PDF и существует в двух вариантах:
    • Версия 0.10:
      /usr/local/bin/wkhtmltopdf-amd64
    • Версия 0.12:
      /usr/local/bin/wkhtmltopdf
  • Утилита wkhtmltoimage выполняет рендеринг в файл изображения:
    /usr/local/bin/wkhtmltoimage

Утилиты доступны на хостинге по умолчанию. В примерах ниже для утилиты wkhtmltopdf используется версия 0.12. Чтобы воспользоваться версией 0.10, просто замените в команде название утилиты с wkhtmltopdf на wkhtmltopdf-amd64.

Просмотр краткой документации:

  • wkhtmltopdf:
    wkhtmltopdf -h
  • wkhtmltoimage:
    wkhtmltoimage -h

Просмотр подробной документации:

  • wkhtmltopdf:
    wkhtmltopdf -H
  • wkhtmltoimage:
    wkhtmltoimage -H

Формат запуска:

  • wkhtmltopdf:
    wkhtmltopdf <URL или путь к исходному HTML-файлу> <путь и имя выходного PDF-файла>
  • wkhtmltoimage:
    wkhtmltoimage <URL или путь к исходному HTML-файлу> <путь и имя выходного файла изображения>

Простой пример преобразования веб-страницы:

  • В PDF-документ:
    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-документа:

  • В PDF-документ:
    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.