Генерируем PDF-файлы в веб-проекте: программа wkhtmltopdf

По-моему, wkhtmltopdf можно из композера устанавливать. И для использования тоже врапперы есть, консоль вызывать неудобно.

изначально корректно работающей с кириллицей

Не думал, что в мире UTF-8 для кого-то это до сих пор проблема.

Программа принимает html-код (в виде веб-адреса, пути к файлу либо строки кода) и генерирует на его основе php-файл на сервере.

может PDF?

1. Эмуляцией браузера по прайслисту… А пробовали не на пустой машине, а на VDS запустить? Вы же понимаете, что практически браузер запускаете?
2. Держать прайс на несколько тысяч позиций в переменной — это план победы. Когда он станет под миллион позиций — что делать будете?
3. Имея прайс текстом в одной переменной были проблемы с переводом его в UTF-8? Т.е. функция iconv на переменную не?
4. Вы вот так прямо «запрос-ответ» генерируете нечто большое? А если связь отвалится — будете перегенерировать? Кормите девопсов, которые потом будут предлагать вам облака для решения несуществующей проблемы? :) Не, я тоже генерю иногда на лету, но на 5-6 страничек, которые мне не жалко перегенерить.
5. Кстати, а как прайс становится HTML? Т.е. Вы ещё готовите специальный HTML, который можно превратить в читаемый прайс, коий HTML явно надо делать отдельно от того, что людям показывается. Ну т.е. в каких-то частных случаях этим действительно можно пренебречь, но… Изучаете конвертилку из HTML в PDF, включая шаблоны и вот всякие ключи… Чую бесовщину, обосновать не могу.
6. А LaTeX не? Пакет texmf сейчас вполне развит, даже TTF туда впихивается за милу душу. Генерация текста/таблиц может быть автоматизирована по самое небалуйся. Причем, если без изысков, то и изучать ничего изыскового не надо. Там сразу Вам и разбиение таблиц по страницам, и игра с текстом, и нумерация без явапрограмминга, и в общем чёрт в ступе. Два дня покурить над самим LaTeX, и потом всё делается быстрее, чем HTML-шаблоны.

Я длительное время использовал MPDF, но он медленный, поэтому изучал альтернативы, тестировал разные варианты. Ещё один интересный сопособ: рендрить с помощью Node и PhantomJS: www.npmjs.com/package/phantomjs-pdf

Но я в итоге остановился на wkhtmltopdf. Расскажу свой опыт.

Во-первых, есть готовая обёртка на PHP: github.com/mikehaertl/phpwkhtmltopdf (сам ей не пользуюсь, у меня простая задача, все аргументы зафиксированы, нет смысла в этой обёртке)

Во-вторых, генерировать временный html файл на диске не обязательно, wkhtmltopdf умеет принимать исходный html через stdin, если указать параметр "-" (прочерк). На PHP получается как-то так:

$descriptorspec = [
    0 => ['pipe', 'r']; //stdin
    1 => ['pipe', 'w']; //stdout
    2 => ['pipe', 'w']; //stderr
];

//Обратите внимание на аргументы, которые я передаю при запуске wkthmltopdf 
//--disable-smart-shrinking без этого аргумента, всё становится каких-то не правильных пропорций
//--dpi 96 если принудительно не поставить dpi, то размеры указанные в css в милиметрах на печати будут совсем не такими!
//- последний аргумент это прочерк, чтобы передать html через stdin
//bypass_shell (только для Windows): при установке в TRUE процесс будет запущен в обход оболочки cmd.exe
//это нужно для обхода бага https://bugs.php.net/bug.php?id=60181 "proc_open fails to read quoted whitespaced directories in Windows"
$process = proc_open("/path/to/wkthmltopdf --disable-smart-shrinking --margin-left 20mm --dpi 96 -", $descriptorspec, $pipes, null, null, ['bypass_shell' => true]);

if (is_resource($process)) {
    
    //Пишем в stdin html контейнт
    fwrite($pipes[0], $html);
    fclose($pipes[0]);

    //Читаем результаты и ошибки, если они вам нужны в приложении
    $stdOut = stream_get_contents($pipes[1]);
    $stdErr = stream_get_contents($pipes[2]);
    fclose($pipes[1]);
    fclose($pipes[2]);

    $exitCode= proc_close($process);

}

Более подробно про разные параметры принимаемые wkthmltopdf рекомендую почитать здесь: wkhtmltopdf.org/usage/wkhtmltopdf.txt

Да, если нужен header-html и footer-html, то пара временных html файлов на диске всё-таки понадобится.

В третьих, на Linux машинах есть неприятный баг, что шрифты выглядят меньше, чем при печати в PDF этого же html файла с помощью браузера: github.com/wkhtmltopdf/wkhtmltopdf/issues/2171
По этому багу, в том числе, есть много обсуждений на StackOverflow, но фикса в ближайшее время не предвидится, предлагается workaround: github.com/wkhtmltopdf/wkhtmltopdf/issues/2171#issuecomment-139164039

Но я использую другой подход: есть отдельный windows сервер, на котором запускается wkthmltopdf, а обращение идёт к нему через простенький самописный веб-сервис: принимает html контент в POST и возвращает готовый PDF — так и живём.

Вообще по wkhtmltopdf активность на github почти нулевая, баги не фиксятся, но ничего лучше пока не нашел. Кто знает C++ — присоединяйтесь к проекту, внесите свой вклад в opensource!

Есть ещё www.princexml.com — но он платный и жутко дорогой!

Пару лет уже не генерировал длинные таблицы через wkhtmltopdf, но раньше был баг с разрезанием ячеек и текста в них, если таблица занимала несколько страниц. Насколько я помню, css для переноса на другой лист wkhtmltopdf не понимал.
Наверно это. как уже выше сказали, из-за того, что движок внутри старый используется.

exec($cd); — это пять. Можете смело удалять данную строку, она ничего не делает.