PHPackages                             placidapp/placid-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. placidapp/placid-php

ActiveLibrary[API Development](/categories/api)

placidapp/placid-php
====================

PHP Wrapper around the Placid.app REST API

v1.0.1(3y ago)96.0k↓25%3[1 PRs](https://github.com/placidapp/placid-php/pulls)1MITPHPPHP ^7.4|^8.0

Since Aug 15Pushed 3y ago2 watchersCompare

[ Source](https://github.com/placidapp/placid-php)[ Packagist](https://packagist.org/packages/placidapp/placid-php)[ Docs](https://github.com/placidapp/placid-php)[ RSS](/packages/placidapp-placid-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (1)

[![Placid for PHP - Automatic image creation from templates](https://camo.githubusercontent.com/6bff91cacf7709c705fcc6cf0283c6a33c9f3867c18c6198d97232149787ceea/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d6865616465722d7068702e6a7067)](https://camo.githubusercontent.com/6bff91cacf7709c705fcc6cf0283c6a33c9f3867c18c6198d97232149787ceea/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d6865616465722d7068702e6a7067)

Placid for PHP
==============

[](#placid-for-php)

[![Latest Version](https://camo.githubusercontent.com/a5a167f4edc1573a3e795f81dda9c4a66bfcc67358b79b52592a9d4364e98d98/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f706c616369646170702f706c616369642d7068702e7376673f7374796c653d666c61742d737175617265)](https://github.com/placidapp/placid-php/releases)[![Total Downloads](https://camo.githubusercontent.com/a1df93070bcb6a715cbf7537041476bc7d5d6831727a131fd15221e4cf3c0159/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f706c616369646170702f706c616369642d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/placidapp/placid-php)

This package enables you to automatically create images from [Placid](https://placid.app) templates. You can use the REST API or the URL API to create placid.app embed links with your variables to dynamically set the image content.

About Placid
------------

[](#about-placid)

To use this package, you will need a [Placid](https://placid.app) account, where you can add, design and edit image templates.

It is a service that automatically creates share images for your content: Open Graph images (og:images), Twitter Card images and Pinterest images. This saves you hours to make your content shareable after publishing. We offer a bunch of nice preset designs you can use out of the box as well.

**More than share images:** With our editor you have full control over your templates, so you can use it for other types of images to add to your content as well (like teasers or blog graphics).

Installation
------------

[](#installation)

You can install this package via composer using this command:

```
composer require placidapp/placid-php
```

Create a placid.app image URL
-----------------------------

[](#create-a-placidapp-image-url)

```
use Placid\Template;

$templateId = "qsraj";
$apiKey = "your-placid-api-key";

$template = new Template($templateId, $apiKey)
$template
    ->elementText($title)
    ->text("I am a dynamic image");

$imageURL = $template->toPlacidUrl(); // - https://placid.app/u/qsraj?title=I%20am%20a%20dynamic%20Image%21
```

[![Dynamically created image with Placid](https://camo.githubusercontent.com/650ba96c0d47048220b1ff4fc93bcb2dd683baf56bb7db05d76e309b2d1a5011/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d646f6b752d616e696d6174696f6e5f6f70742e676966)](https://camo.githubusercontent.com/650ba96c0d47048220b1ff4fc93bcb2dd683baf56bb7db05d76e309b2d1a5011/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d646f6b752d616e696d6174696f6e5f6f70742e676966)

Generate an image
-----------------

[](#generate-an-image)

Using the `image()` function on the template object will result in returning a [GeneratedImage Object](https://github.com/placidapp/placid-php/blob/master/src/GeneratedImage.php). When the image has been created, the webhook defined in your config will be called.

```
 $image = $template->image();
```

`image(true)` will wait for the image to being finished:

```
 $image = $template->image(true); // - https://placid.app/u/qsraj?title=I%20am%20a%20dynamic%20Image%21
```

Fields
------

[](#fields)

You can add different elements onto your template that can be changed and filled dynamically.

### Text field

[](#text-field)

```
$template
    ->elementText("text") // - Layer name in your template
    ->text("This is the text")
    ->color('#ff0022'); // - Text color as hex-code
```

**PLEASE NOTE:** The text color can only be changed when you use the `image()` function to generate an image, not if you use the URL API.

### Picture field

[](#picture-field)

```
$template
    ->elementPicture('picture') // - Layer name in your template
    ->imageFromUrl(
        "https://madewithvuejs.com/mandant/madewithvuejs/images/logo.png" // - image source
    );

$template
    ->elementPicture('picture') // - Layer name in your template
    ->imageFromWebsite("https://madewithvuejs.com"); // - URL of a page to screenshot
```

### Browserframe field

[](#browserframe-field)

```
$template
    ->elementBrowserframe('browserframe') // - Layer name in your template
    ->imageFromUrl(
        "https://madewithvuejs.com/mandant/madewithvuejs/images/logo.png" // - image source
    )
    ->url("madewithvuejs.com"); // - URL that will be displayed in the browserframe's address bar

$template
    ->elementBrowserframe('browserframe') // - Layer name in your template
    ->imageFromWebsite("https://madewithvuejs.com") // - URL of a page to screenshot
    ->url("madewithvuejs.com"); // - URL that will be displayed in the browserframe's address bar
```

### Rectangle field

[](#rectangle-field)

```
$template
    ->elementRectangle('rectangle') // - Layer name in your template
    ->backgroundColor("#000000"); // - Background color as hex-code
```

**PLEASE NOTE:** The background color can only be changed when you use the `image()` function to generate an image, not if you use the URL API.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 70.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1070 days

Total

2

Last Release

1398d ago

PHP version history (2 changes)v1.0PHP ^7.1

v1.0.1PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/4766aac7f4ee1481e28c8b2f9e53b1c019b5006fb77582972c8c69e98c4c8b17?d=identicon)[arminulrich](/maintainers/arminulrich)

---

Top Contributors

[![arminulrich](https://avatars.githubusercontent.com/u/632486?v=4)](https://github.com/arminulrich "arminulrich (12 commits)")[![ghostzero](https://avatars.githubusercontent.com/u/6547306?v=4)](https://github.com/ghostzero "ghostzero (5 commits)")

---

Tags

imagesphpplacidplacid-php

### Embed Badge

![Health badge](/badges/placidapp-placid-php/health.svg)

```
[![Health](https://phpackages.com/badges/placidapp-placid-php/health.svg)](https://phpackages.com/packages/placidapp-placid-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)