Чем конвертировать html в pdf
Конвертируем HTML в PDF при помощи Dompdf
PDF — формат, ставший уже стандартом. Он был изначально создан Adobe для представления текста и изображений в документе с фиксированной структурой. Давно не редкость для веб-приложений, поддерживающих скачку данных, таких как счета или отчеты, отдавать их в PDF формате. Так что в этой статье мы пройдем простую генерацию PDF документов используя PHP.
Dompdf — это отличная библиотека, способная генерировать PDF из HTML-разметки и CSS-стилей (в большинстве случаев это стили, совместимые с CSS 2.1 с поддержкой некоторых свойств CSS3). Мы можем определить, как наше содержимое должно выглядеть, используя эти знакомые технологии, и после легко конвертировать его в фиксированный документ. Также эта библиотека имеет и другие полезные и интересные функции.
Приступаем к работе
Dompdf доступен на GitHub и может быть установлен используя Composer. Установка через Composer без каких-либо ошибок часто вызывает трудности, поэтому я рекомендую просто использовать Git для установки Dompdf.
Библиотека требует PHP >= 5.0 с активированными расширениями mbstring и DOM. Также она требует несколько шрифтов, которые обычно доступны на большинстве компьютеров.
Перейдите в директорию, куда собираетесь установить библиотеку и выполните в командной строке:
Как только мы скачали Dompdf, давайте напишем короткий пример, который сгенерирует простой PDF документ:
Для того, чтобы использовать библиотеку в проекте, мы сначала подтягиваем файл dompdf_config.inc.php, который содержит большую часть конфигурации Dompdf. Он также загружает autoloader и пользовательский файл конфигурации в котором мы можем переопределить параметры по умолчанию.
HTML-разметка передается как строка в метод load_html(). Альтернативно мы можем загрузить разметку из файла или URL, используя метод load_html_file(). Он принимает имя файла или URL веб-страницы в качестве аргумента.
Метод render() отображает HTML в PDF, и мы готовы к отдаче файла. Метод stream() отправляет результирующий PDF как вложение в браузер. Этот метод имеет необязательный второй параметр, массив опций:
Только что мы сгенерировали очень простой PDF, но это не совсем практично. В реальности мы часто имеем требования к размеру листа, ориентации страницы, кодировке символов и т.д. Есть целый набор опций, которые мы можем установить, чтобы сделать Dompdf более подходящим для наших реальных потребностей. Все они перечислены и объяснены в файле dompdf_config.inc.php, который устанавливает им значения по умолчанию. Вы можете менять эти значения, обновляя файл пользовательской конфигурации dompdf_config.custom.inc.php. Вот некоторые из важных настроек:
Продвинутое использование
Теперь давайте немного поговорим о продвинутом использовании Dompdf. Возможно мы хотим сохранить сгенерированный PDF документ на диск, вместо того чтобы отсылать его в браузер. Вот как это делается:
Вместо вызова stream(), как в прошлом примере, мы используем output(), который возвращает PDF как строку. Этот метод также принимает массив опций, но доступна лишь одна — compress (по умолчанию true).
Dompdf также позволяет нам добавлять хедер и футер к сгенерированному PDF, встраивая PHP-скрипт прямо в HTML, который он отображает. Но из-за того, что обработка произвольного кода может представлять из себя угрозу безопасности, значение конфигурации, которое отвечает за эту функциональность, по умолчанию выключено. Нам необходимо для начала установить опцию DOMPDF_ENABLE_PHP как true.
Как только мы включили выполнение встроенного PHP, объект PDF станет доступным внутри скрипта и мы сможем использовать его для манипуляций со страницей. Мы можем добавлять текст, линии, изображения, прямоугольники и т.д.
Скрипт встроен прямо в HTML-разметку и сначала открывает объект, чтобы мы могли влиять на отображение. Вся отрисовка будет записана в этот объект и мы сможем добавить его на все выделенные страницы (хотя есть и ограничения).
Затем мы получаем реальную ширину и высоту страницы, чтобы посчитать координаты футера, который мы собираемся добавить. Также нам требуется предоставить обьект шрифта, поскольку мы добавляем текстовое содержимое. Font_Metrics::get_font() позволяет создать объект, который нам необходим. Мы также берем высоту данного шрифта из его размера используя get_font_height(), чтобы посчитать позиционирование содержимого футера. Метод get_font_width() возвращает ширину нашего текста для данного шрифта и размера, которую мы также используем в наших вычислениях.
Метод line() рисует линию из точки (X1,Y1) в точку (X2,Y2). Обратите внимание, значение цвета подставляется не совсем в RGB. Основной PDF-класс требует значения между 0 и 1, так что мы конвертируем значения RGB в эти новые значения. Чтобы получить лучшее приближение (approximation), вы можете поделить их на 255.
Мы добавляем номер для каждой страницы, используя метод page_text(), которой принимает координаты X и Y, а также текст, который будет добавлен, объект шрифта, размер шрифта и цвет. Dompdf автоматически заменяет значения для и на каждой странице, и делает $pdf доступным для нас.
Также мы можем не использовать встроенный PHP и достигать аналогичного эффекта прямо из PHP, примерно так:
Обратите внимание, мы размещаем код после вызова $dompdf->render() потому что мы, по существу, редактируем уже созданный PDF.
Подведем итоги
В этой статье мы обсудили простой способ конвертировать HTML в PDF используя Dompdf. Несмотря на то, что Dompdf отличная библиотека, она не является полностью универсальным решением для генерации PDF документов; она все же имеет определенные ограничения и проблемы. Dompdf не очень терпимо относится к плохо оформленному HTML и большие таблицы могут легко привести к переполнению памяти. Некоторые базовые функции CSS, такие как float не полностью поддерживаются. И вообще, поддержка CSS3 очень ограничена. Если вам необходимы функции, которые не поддерживаются в Dompdf, вам может помочь к примеру wkhtmltopdf. Тем не менее, Dompdf является очень простым и удобным инструментом для решения большинства задач по экспорту PDF.
На самом деле довольно трудно объяснить все функции библиотеки в статье вроде этой, поэтому не забудьте просмотреть документацию и исходный код, а также изучите такие полезные функции, как добавление колбэков, использование своих шрифтов и др.
Преобразование веб-страниц в PDF
Ядром веб-страницы является файл, написанный на языке разметки гипертекста (HTML). Обычно HTML-файл включает связи с другими файлами, которые либо отображаются на веб-странице, либо определяют внешний вид или работу страницы.
Конечный файл PDF действует аналогично исходной веб-странице. Например, изображения, ссылки, карты изображений и большинство файлов мультимедиа отображаются и работают обычным образом в PDF (Анимированные файлы в формате GIF отображаются в виде неподвижных изображений, показывая последний кадр анимации.)
Такой файл PDF функционирует как любой другой файл PDF. Например, можно перемещаться по файлу при помощи прокрутки или закладок; пользователи могут добавлять комментарии; можно добавить функции защиты, поля формы и иные функции, которые расширяют работу с файлом.
При подготовке к преобразованию веб-страниц в PDF, учитывайте следующие рекомендации, которые влияет на ваш подход к процессу преобразования.
Какой объем необходимо преобразовать?
Необходимо создать новый файл PDF из веб-страниц или добавить преобразованные страницы к существующему файлу PDF?
Для преобразования веб-страниц на китайском, японском и корейском языках (CJK) в PDF на Западноевропейской системе в Windows при установке Acrobat необходимо установить файлы поддержки языков CJK. Также лучше выбирать соответствующую кодировку из параметров преобразования HTML.
Преобразование веб-страниц в PDF в Internet Explorer, Google Chrome и Firefox (Windows)
Acrobat устанавливает панель инструментов Adobe PDF в браузере Internet Explorer (версия 8.0 или более поздняя), Google Chrome и Firefox. Используя команды на этой панели инструментов, вы можете преобразовать отображаемую веб-страницу в PDF различными способами. Например, вы можете преобразовать всю веб-страницу или только ее выделенные области. Также вы можете создать документ PDF или добавить преобразованную веб-страницу к существующему файлу PDF. Меню панели инструментов также содержит команды, с которых начинаются дальнейшие действия после преобразования, например присоединение созданного файла PDF к новому сообщению электронной почты или его печать.
Конвертация HTML в PDF
(всего 3000 рублей)
Часто встречается мнение, что формат PDF лучше, чем html или наоборот, сильные аргументы в поддержку конвертации pdf страниц в html. Также пишут, что лучше всего конвертировать html страницы в pdf, так как тогда файлы получаются гораздо более высокого качества. Давайте проясним ситуацию.Два формата для разных целей. PDF (Portable Document Format) Был разработан для работы с материалами со сложным оформлением. PDF файлы обычно используются для проектов, которые требуют высокой точности или для типографий. PDF файлы всегда выглядят великолепно и одинаково, какой бы вы ни выбрали браузер для просмотра. PDF файлы не очень удобно просматривать, если у вас маленький экран – вы должны постоянно прокручивать страницу, чтобы посмотреть все изображение. Кроме того, копирование текста с PDF файлов это сложный процесс, так как если текст размещен сбоку, при выделении очень мешают разрывы страниц.
Большинство людей считает разумным печатать с формата PDF, но только не просматривать файлы такого формата на компьютере! Для просмотра информации через браузеры гораздо предпочтительнее и удобнее будет использовать HTML формат. Однако, до сих пор для пользователей это дело личного вкуса и предпочтений. Для тех, кто привык работать с PDF страницами, удобно конвертировать HTML в PDF формат, не смотря на его преимущества или недостатки.
Как это можно сделать?
Total HTML Converter имеет множество опций, которые превращают процесс конвертации в сплошное удовольствие. Во-первых, режим пакетной конвертации. Вы можете конвертировать одновременно более 800 файлов также легко и быстро, как один файл. Второе, вы может запускать Total HTML Converter с помощью Командной строки из любой программы. Третье, интерфейс программы понятен на интуитивном уровне и даже ребенок может справиться с ней.
Разбираем возможности конвертирования HTML в PDF браузером Google Chrome
Недавно в одном стартапе я решал задачу генерации билетов в формате PDF. На тот момент уже был готов сайт с устоявшимся стеком технологий, поэтому я искал подход, который бы не потребовал использования дополнительных инструментов. В итоге я предложил сперва создавать билеты в формате HTML, а затем конвертировать в PDF с помощью браузера Chrome. Как оказалось, данным способом можно генерировать не только билеты, богато декорированные CSS, но и самые разные отчеты с графиками на JavaScript. В этой статье я расскажу о том, как для этих целей запустить Chrome, дам несколько советов по настройке CSS, а так же обсужу недостатки данного решения.
Здесь не будут обсуждаться альтернативные варианты, потому как по ним написано уже достаточно, их легко найти, и они представляют собой готовые инструменты, информацию по которым лучше смотреть в первоисточниках — в документациях на официальных сайтах. Предлагаемый способ не является самостоятельным инструментом и больше похож на побочный продукт развития нескольких технологий. В русскоязычном сегменте интернета собранной воедино информации по нему немного, поэтому я и решил восполнить пробел.
Почему выбран именно этот вариант?
Самым главным преимуществом является то, что для генерации PDF браузером Chrome не нужно расширять технологический стек. Фронтенд разработчики создают HTML привычными средствами разработки и сразу видят промежуточные результаты труда в браузере. В это же время Chrome уже наверняка крутится в тестах и перенести его на бекенд не составляет большого труда. Так же следует отметить тот факт, что верстальщику становится доступен весь арсенал css свойств включая Flexbox и Grid.
О недостатках и способах их обхода я расскажу по ходу статьи.
Решаем задачу одной строкой
В командной строке вызываем Chrome в безголовом режиме с сохранением страницы в pdf:
Если у Вас уже есть генератор HTML документов, вместо https://google.com укажите URL для получения этого документа.
Добавляем CSS
Запускаем Chrome через Selenium
Для получения PDF файла можно запустить этот пример из командной строки указав url и имя файла для сохранения PDF, либо вызвать функцию get_pdf_from_html и передать ей три аргумента:
Теперь разберемся, какие средства доступны для контроля размещения контента на многостраничных документах.
Типографика в CSS
При двусторонней печати можно задать разные отступы от края для правых и левых страниц по отдельности если в дальнейшем предполагается брошюровка:
Для первой страницы можно задать собственное оформление, например, увеличенный отступ от верхнего края:
Есть возможность установить разрыв страницы перед заголовком первого уровня так, чтобы он начинался на нечетной странице:
Посредством свойства page-break-after можно запретить разрыв страницы сразу после некоторого элемента, например, заголовка второго уровня:
Свойство page-break-inside поможет избежать разрыва страниц там, где делать это нежелательно, например посреди таблицы
Свойства orphans и orphans помогут избежать разрыва страниц в начале и в конце абзаца:
Что с производительностью?
На Core i5-8600K 3600MHz в один поток одно преобразование простого документа выполняется за 0.6 сек. На моей портативной печатной машинке конца 2013 года 2.4 Ггц — 1.5 секунды.
Очевидно, что основные ресурсы тратятся на запуск браузера. Можно сократить время преобразования большого количества файлов, если запустить Chrome один раз как микросервис и отправлять ему URL для преобразования. Реализация этого способа выходит за рамки данной статьи.
Что еще не так?
Я вижу две основные проблемы:
Выводы
Выводы о допустимости использования такого подхода предлагаю сделать самостоятельно. Каждый проект уникален по своему. Подойдет ли этот способ в Вашем проекте, решать Вам.
Преобразование HTML в PDF
Конвертируйте файлы HTML в PDF без проблем. Конвертируйте файлы или веб-страницы HTML в PDF одним щелчком мыши. Используйте наш онлайн-конвертер HTML в PDF. Это просто и БЕСПЛАТНО*!
Ваши файлы хранятся на наших серверах только 24 часа, после чего они навсегда удаляются.
Конвертирование файлов HTML в PDF
1 Введите URL веб-сайта
Для конвертирования файла или веб-страницы HTML в PDF введите URL-адрес веб-сайта в соответствующее поле. Обязательно укажите полный URL, включая http:// или https://.
2 Просмотр и загрузка файла
После завершения конвертирования файла просмотрите новый документ, загрузив файл, конвертированный из HTML в PDF, на свой компьютер и открыв его непосредственно в веб-браузере онлайн.
Файлы PDF выглядят как распечатанные веб-страницы
Дополнительная информация о сохранении веб-страницы в формате PDF
Просмотр с непрерывной прокруткой
Конвертирование файлов HTML в PDF выполняется просто и бесплатно. Длинная страница? Длинный PDF! Если содержимое вашей веб-страницы или документа превышает длину одной страницы в формате PDF, оно будет продолжено на следующих страницах. Выберите режим просмотра файла PDF с непрерывной прокруткой для просмотра вашего файла HTML так, как в браузере.
Цветовые слои веб-сайта
Некоторые веб-сайты могут иметь такие элементы, как меню или цветовые слои, требующие принять условия просмотра, которые остаются на странице при прокрутке. При конвертировании файлов HTML в PDF эти элементы появляются на каждой странице файла PDF.
Конвертирование файлов в исходный формат
*Могут применяться ограничения в отношении размера и ежедневного использования. Avanquest 2021, все права защищены.