PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$result = new \wkhtmltox\Image\Converter('<h1>Счёт №42</h1><p>Итого: 12 500 ₽</p>', ['fmt' => 'png', 'screenWidth' => 720]);
echo get_class($result), PHP_EOL;

wkhtmltox\Image\Converter::__construct: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: wkhtmltox\Image\Converter

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$result = new \wkhtmltox\Image\Converter('<h1>Акт №73</h1><p>Статус: готов</p>', ['fmt' => 'jpg', 'quality' => 90, 'screenWidth' => 1200]);
echo get_class($result), PHP_EOL;

wkhtmltox\Image\Converter::__construct: создаётся Image Converter с документированным форматом jpg; этот пример проверяет тип объекта, а байты изображения проверяются отдельно в convert(). Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: wkhtmltox\Image\Converter

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\Image\Converter('<h1>Счёт №42</h1><p>Итого: 12 500 ₽</p>', ['fmt' => 'png', 'screenWidth' => 720]);
$result = $converter->convert();
if (!is_string($result) || !str_starts_with($result, "\x89PNG\r\n\x1a\n")) { throw new RuntimeException('Изображение не имеет ожидаемой сигнатуры'); }
echo 'bytes=', strlen($result), PHP_EOL;

wkhtmltox\Image\Converter::convert: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: bytes=<положительное число>; первые байты соответствуют выбранному PNG/JPEG.

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\Image\Converter('<h1>Акт №73</h1><p>Статус: готов</p>', ['fmt' => 'jpg', 'quality' => 90, 'screenWidth' => 1200]);
$result = $converter->convert();
if (!is_string($result) || !str_starts_with($result, "\xFF\xD8")) { throw new RuntimeException('Изображение не имеет ожидаемой сигнатуры'); }
echo 'bytes=', strlen($result), PHP_EOL;
$directory = __DIR__ . '/exports';
if (!is_dir($directory) && !mkdir($directory, 0775, true) && !is_dir($directory)) {
    throw new RuntimeException('Не создан каталог exports');
}
$path = $directory . '/delivery-73.jpg';
if (file_put_contents($path, $result, LOCK_EX) === false) { throw new RuntimeException('JPEG не сохранён'); }
echo basename($path), ' sha256=', hash_file('sha256', $path), PHP_EOL;

wkhtmltox\Image\Converter::convert: HTML преобразуется в JPEG с документированным fmt=jpg; проверяются сигнатура FF D8, сохранённый файл и его SHA-256. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: bytes=<положительное число>; первые байты FF D8. delivery-73.jpg sha256=<64 hex-символа>

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\Image\Converter('<h1>Счёт №42</h1><p>Итого: 12 500 ₽</p>', ['fmt' => 'png', 'screenWidth' => 720]);
$result = $converter->getVersion();
echo $result, PHP_EOL;

wkhtmltox\Image\Converter::getVersion: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: Строка версии, если она реализована используемой libwkhtmltox; официальный мануал предупреждает, что Image getVersion может быть не реализован.

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\Image\Converter('<h1>Акт №73</h1><p>Статус: готов</p>', ['fmt' => 'jpg', 'quality' => 90, 'screenWidth' => 1200]);
$result = $converter->getVersion();
echo $result, PHP_EOL;

wkhtmltox\Image\Converter::getVersion: запрашивается только версия движка; пример не заявляет проверку изображения и сохраняет официальное предупреждение о возможной нереализованности метода. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: Строка версии, если она реализована используемой libwkhtmltox; официальный мануал предупреждает, что Image getVersion может быть не реализован.

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'margin.top' => '12mm']);
$page = new \wkhtmltox\PDF\Object('<h1>Счёт №42</h1><p>Итого: 12 500 ₽</p>', ['useExternalLinks' => false, 'produceForms' => false]);
$converter->add($page);
echo 'page=added', PHP_EOL;

wkhtmltox\PDF\Converter::add: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: page=added

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'orientation' => 'Landscape']);
$page = new \wkhtmltox\PDF\Object('<h1>Акт №73</h1><p>Статус: готов</p>', ['useExternalLinks' => false, 'produceForms' => false]);
$converter->add($page);
echo 'page=added', PHP_EOL;
$appendix = new \wkhtmltox\PDF\Object('<h2>Приложение</h2><p>Позиции акта</p>', ['useExternalLinks' => false]);
$converter->add($appendix);
$bytes = $converter->convert();
if (!is_string($bytes) || !str_starts_with($bytes, '%PDF-')) { throw new RuntimeException('PDF не собран'); }
echo 'pages=2 pdf-bytes=', strlen($bytes), PHP_EOL;

wkhtmltox\PDF\Converter::add: используется другой HTML и параметры рендера; результат проверяется по типу либо сигнатуре соответствующего артефакта. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: pages=2 pdf-bytes=<положительное число>, сигнатура %PDF-.

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'margin.top' => '12mm']);
$result = $converter;
echo get_class($result), PHP_EOL;

wkhtmltox\PDF\Converter::__construct: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: wkhtmltox\PDF\Converter

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'orientation' => 'Landscape']);
$result = $converter;
echo get_class($result), PHP_EOL;
$result->add(new \wkhtmltox\PDF\Object('<h1>Акт №73</h1>', ['useExternalLinks' => false]));
$bytes = $result->convert();
if (!is_string($bytes) || !str_starts_with($bytes, '%PDF-')) { throw new RuntimeException('PDF не собран'); }
echo 'configured-pdf-bytes=', strlen($bytes), PHP_EOL;

wkhtmltox\PDF\Converter::__construct: используется другой HTML и параметры рендера; результат проверяется по типу либо сигнатуре соответствующего артефакта. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: wkhtmltox\PDF\Converter configured-pdf-bytes=<положительное число>.

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'margin.top' => '12mm']);
$page = new \wkhtmltox\PDF\Object('<h1>Счёт №42</h1><p>Итого: 12 500 ₽</p>', ['useExternalLinks' => false, 'produceForms' => false]);
$converter->add($page);
$result = $converter->convert();
if (!is_string($result) || !str_starts_with($result, '%PDF-')) { throw new RuntimeException('Полученные байты не похожи на PDF'); }
echo 'pdf-bytes=', strlen($result), PHP_EOL;

wkhtmltox\PDF\Converter::convert: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: pdf-bytes=<положительное число>, сигнатура %PDF-.

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'orientation' => 'Landscape']);
$page = new \wkhtmltox\PDF\Object('<h1>Акт №73</h1><p>Статус: готов</p>', ['useExternalLinks' => false, 'produceForms' => false]);
$converter->add($page);
$result = $converter->convert();
if (!is_string($result) || !str_starts_with($result, '%PDF-')) { throw new RuntimeException('Полученные байты не похожи на PDF'); }
echo 'pdf-bytes=', strlen($result), PHP_EOL;
$directory = __DIR__ . '/exports';
if (!is_dir($directory) && !mkdir($directory, 0775, true) && !is_dir($directory)) {
    throw new RuntimeException('Не создан каталог exports');
}
$path = $directory . '/delivery-73.pdf';
if (file_put_contents($path, $result, LOCK_EX) === false) { throw new RuntimeException('PDF не сохранён'); }
echo basename($path), PHP_EOL;

wkhtmltox\PDF\Converter::convert: используется другой HTML и параметры рендера; результат проверяется по типу либо сигнатуре соответствующего артефакта. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: pdf-bytes=<положительное число>, сигнатура %PDF-. delivery-73.pdf

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'margin.top' => '12mm']);
$result = $converter->getVersion();
echo $result, PHP_EOL;

wkhtmltox\PDF\Converter::getVersion: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: Строка версии libwkhtmltox.

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4', 'orientation' => 'Landscape']);
$result = $converter->getVersion();
echo $result, PHP_EOL;
if (!is_string($result) || trim($result) === '') { throw new RuntimeException('Версия движка не определена'); }
echo 'renderer-version-recorded', PHP_EOL;

wkhtmltox\PDF\Converter::getVersion: используется другой HTML и параметры рендера; результат проверяется по типу либо сигнатуре соответствующего артефакта. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: Непустая строка версии libwkhtmltox. renderer-version-recorded

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$result = new \wkhtmltox\PDF\Object('<h1>Счёт №42</h1><p>Итого: 12 500 ₽</p>', ['useExternalLinks' => false, 'produceForms' => false]);
echo get_class($result), PHP_EOL;

wkhtmltox\PDF\Object::__construct: показан минимальный объектный жизненный цикл этой операции. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: wkhtmltox\PDF\Object

<?php
declare(strict_types=1);

if (!extension_loaded('wkhtmltox')) {
    throw new RuntimeException('Нужно расширение wkhtmltox');
}

$result = new \wkhtmltox\PDF\Object('<h1>Акт №73</h1><p>Статус: готов</p>', ['useExternalLinks' => false, 'produceForms' => false]);
echo get_class($result), PHP_EOL;
$converter = new \wkhtmltox\PDF\Converter(['size.pageSize' => 'A4']);
$converter->add($result);
$bytes = $converter->convert();
if (!is_string($bytes) || !str_starts_with($bytes, '%PDF-')) { throw new RuntimeException('Объект не вошёл в PDF'); }
echo 'object-rendered-bytes=', strlen($bytes), PHP_EOL;

wkhtmltox\PDF\Object::__construct: используется другой HTML и параметры рендера; результат проверяется по типу либо сигнатуре соответствующего артефакта. Runtime требует совместимые wkhtmltox extension и libwkhtmltox; локально выполнен lint.
Что должно получиться в совместимом окружении: wkhtmltox\PDF\Object object-rendered-bytes=<положительное число>.