oxhq/pliego-php

PHP client for one-shot Pliego document rendering

Maintainers

Package info

github.com/oxhq/pliego-php

pkg:composer/oxhq/pliego-php

Transparency log

Statistics

Installs: 71

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.2.1 2026-08-22 13:59 UTC

Requires

  • php: ^8.3

MIT 1b8b1a524e64e55caeb60cfa7c31769c2d9484c8

Published on Packagist.org on 2026-08-22 14:00 UTC

This package is auto-updated.

Last update: 2026-08-22 14:00:01 UTC

README

PHP 8.3+ client for rendering one document per native Pliego process.

The v0.2 PHP package line is published on Packagist; this compatible constraint selects its latest published patch:

composer require oxhq/pliego-php:^0.2.0
composer test

Network access is denied unless RenderOptions::allowedHttpRoots names explicit HTTP(S) roots. Local files must live inside the document input bundle. Host-font fallback and redirects remain disabled by default.

Rendering profile

Static HTML needs no readiness calls. Pliego infers readiness after page load and waits for document.fonts.ready. Call window.pliego.defer() only when JavaScript continues changing the DOM or a canvas after load, followed by ready() after the final change or fail() on error.

Chart.js 4.5.1 is covered for fixed, non-animated charts that complete a synchronous full-canvas getImageData(0, 0, canvas.width, canvas.height) readback before ready(). The retained pixels are authoritative for that canvas; the claim does not extend to every Chart.js configuration or Canvas API.

The bridge rejects partial scene capture without publishing the requested PDF and preserves retained artifacts for diagnosis.

PDF paint currently retains resolved sRGB text colors, solid backgrounds, uniform-color sharp axis-aligned solid borders, and uniform solid collapsed-table borders. CSS gradients and background-image layers, box and text shadows, text decorations, rounded or mixed-color borders, clips, non-solid and image borders, transforms, opacity, filters, and blend modes are explicitly unsupported and reported rather than approximated.

Resource examples:

Results and typed render exceptions expose jobPath, inputBundlePath, and artifactsPath. These directories may contain private input, PDFs, extracted text, URLs, and diagnostics; remove them after acceptance when the evidence is no longer needed.

With the v0.2 API 1 runtime, artifactsPath is the requested locator, not an existence guarantee. Path and publication-parent checks occur before the document process; external PDF preparation is held after a normal child exit and before artifact visibility. Deterministic overlap, existing-output, preparation, and transaction failures create no public artifact tree. Check is_dir($error->artifactsPath) before reading diagnostics. The SDK job and input-bundle retention record remains available for an invoked job.

See the project support profile for the current rendering and resource boundaries.