Ми використовуємо cookie-файли
Для оптимізації роботи нашого сайту ми використовуємо cookie-файли. Продовжуючи використовувати сайт, Ви погоджуєтеся з використанням cookie-файлів.
Новий дизайн
Панель керування
  • Русский
  • Українська
  • English
  • UAH
  • USD
  • RUB
  • EUR
  • 0-800-307-307 Гаряча лінія
  • +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 Київстар
  • +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.