Create images and PDFs in PHP

Each method takes a template id and an options array. Every option is optional.

Create an image

createImage renders the template and returns the image bytes.

#templateIdstringrequired

The template id, for example tpl_xxx.

#modificationsarray

The values to put into the template’s layers. Each entry is an array that names a layer with name. Layers you leave out keep the values from the template. Modifications lists the fields each layer accepts.

#formatstringdefault: png

The image format: png, jpeg, or webp.

$result = $client->createImage('tpl_xxx', [
    'modifications' => [
        ['name' => 'headline', 'text' => 'Launch promo'],
        ['name' => 'price', 'text' => '$29'],
    ],
    'format' => 'webp',
]);

if (isset($result['error'])) {
    throw new RuntimeException($result['error']['message']);
}

file_put_contents('launch-promo.webp', $result['result']);

In a web request, send the bytes with the matching Content-Type header, for example image/webp.

Create a PDF

createPdf takes the same modifications option. It has no format option.

$result = $client->createPdf('tpl_invoice', [
    'modifications' => [
        ['name' => 'customer', 'text' => 'Acme Studio'],
        [
            'name' => 'line-items',
            'columns' => ['Item', 'Qty', 'Total'],
            'rows' => [['Item' => 'Automate plan', 'Qty' => 1, 'Total' => '$29.00']],
        ],
    ],
]);

if (isset($result['error'])) {
    throw new RuntimeException($result['error']['message']);
}

file_put_contents('invoice.pdf', $result['result']);

Create a stored image

createStoredImage renders the image, saves it on the Bannerify CDN, and returns a URL instead of the bytes. The URL starts with https://images.bannerify.co/files/. Use it when you want to put the link in an email, a database row, or a no-code tool.

It takes the same options as createImage.

$result = $client->createStoredImage('tpl_xxx', [
    'modifications' => [
        ['name' => 'headline', 'text' => 'Welcome back'],
    ],
]);

if (isset($result['error'])) {
    throw new RuntimeException($result['error']['message']);
}

echo $result['result'];

The PHP SDK cannot send s3Config. To save the file to your own bucket, call Create stored image over REST.

Handle the result

All three methods return ['result' => ...] or ['error' => ...]. See Handle errors.