airlst/headless-browser-client

AirLST Headless Browser PHP Client

3.0.0 2024-11-14 16:09 UTC

This package is auto-updated.

Last update: 2024-11-14 16:09:47 UTC


README

Latest Version on Packagist Total Downloads

PHP Client to interact with AirLST Headless Browser service.

Installation

You can install the package via Composer:

composer require airlst/headless-browser-client

Usage

Initialize the headless browser client with your API key.

$headlessBrowser = new \AirLST\HeadlessBrowserClient\AirlstHeadlessBrowser('api-key-here');

Generate PDF from HTML

Using standard format

$headlessBrowser->pdf(
    '<p>html</p>', // html content
    [10, 10, 10, 10] // margins
    'A4', // page size
);

Using custom size

$headlessBrowser->pdf(
    '<p>html</p>', // html content
    [10, 10, 10, 10] // margins
    null, // Page size must be null otherwise it will override the custom width and height
    '80mm', // width
    '60mm', // height
);

Generate JPEG from HTML

$headlessBrowser->jpeg(
    '<p>html</p>', // html content
    80, // quality
);

Response

All methods return the \Airlst\HeadlessBrowserClient\Response object. Provides 2 public methods:

  • temporaryUrl() - returns a temporary file URL stored in the S3 bucket. Expires in 5 minutes after generation
  • contents() - downloads file from S3 bucket and returns contents of the file as string

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email hey@orkhan.dev instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.