PHPackages                             nicoverbruggen/image-generator - 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. [Image & Media](/categories/media)
4. /
5. nicoverbruggen/image-generator

ActiveLibrary[Image & Media](/categories/media)

nicoverbruggen/image-generator
==============================

Generate placeholder images with a specific size, color and text (optional).

v4.1.0(3mo ago)3135.8k↓36.6%6MITPHPPHP >=8.1CI failing

Since Dec 6Pushed 3mo agoCompare

[ Source](https://github.com/nicoverbruggen/image-generator)[ Packagist](https://packagist.org/packages/nicoverbruggen/image-generator)[ RSS](/packages/nicoverbruggen-image-generator/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (6)Dependencies (2)Versions (11)Used By (0)

Image Generator
===============

[](#image-generator)

This package is intended to be used for quickly generating placeholder images with a specific size, color and text. For more complex use cases, you may want to turn to something like [stil/gd-text](https://github.com/stil/gd-text).

Requirements
------------

[](#requirements)

- PHP 8.1 or higher
- GD extension

Usage
-----

[](#usage)

Make sure you require this package in your composer.json:

```
composer require nicoverbruggen/image-generator

```

See [the example source file](examples/saved.php) that is used to generate and save the sample images. You can generate the following examples:

[![The barebones example](doc/examples/barebones.png)](doc/examples/barebones.png)[![A multiline example](doc/examples/multiline.png)](doc/examples/multiline.png)[![An avatar](doc/examples/avatar.png)](doc/examples/avatar.png)

Please note that for testing purposes, I used Roboto Black as the TrueType font. (This font is not included in this repository.)

Here's a few examples of what you can do with this package:

### Save images to a path

[](#save-images-to-a-path)

```
use NicoVerbruggen\ImageGenerator\ImageGenerator;

(new ImageGenerator())->generate(output: __DIR__ . "/image_example.png", size: '200x200');
```

### Generate `base64` encoded images inline

[](#generate-base64-encoded-images-inline)

In addition to saving placeholder images to a particular location, you can also output a base64 encoded string:

```
use NicoVerbruggen\ImageGenerator\ImageGenerator;

$output = (new ImageGenerator())->generate(output: 'base64', size: '200x200');

echo "";
```

A useful use case may be achieved after declare your own helper, like so:

```
function placeholder_image(string $size = '500x500'): string {
    return (new ImageGenerator())->generate(output: 'base64', size: $size);
}
```

This use case can be useful when used in combination with frameworks like Laravel or Symfony:

```

    Item

```

### Directly output images

[](#directly-output-images)

You can also check out [the other source file](examples/direct.php). You can point your browser directly at this file (assuming you're running a PHP server, of course) and it will directly return a file since the path is set to `null`.

### Server mode

[](#server-mode)

You can also point your PHP installation's webroot to the `server` directory, and generate images via URL.

- The `size` parameter is used to size the placeholder images.
- The `background_color` parameter is used to set the background color.
- The `text_color` parameter is used to set the color of the text (of the dimensions).

Please note that you should not use `#` in the URL for the hexadecimal notation for colors!

You can then link to the domain you're using to host these placeholders.

For example, if it is `image-generator.test`:

```

    Item

```

Notes
-----

[](#notes)

If you do not supply a TrueType font path:

- you will be limited in font size options (1 through 5)
- you will not be able to render multiline text

Upgrade guide
-------------

[](#upgrade-guide)

### v2 to v3:

[](#v2-to-v3)

In `ImageGenerator`, `makePlaceholderImage()` has been removed. You need to replace all usages of it with `generate()`.

### v3 to v4:

[](#v3-to-v4)

In `ImageGenerator`, `generate()`'s `path` parameter has been replaced with `output`. If you use named parameters, you will need to update your usage of this method.

It works the same way, but you have more options for this parameter now, in particular `base64` is now a valid value for that parameter.

Tests
-----

[](#tests)

```
./vendor/bin/phpunit tests

```

Contributions
-------------

[](#contributions)

I am not planning to expand the features of this package at this time. If you've made an improvement or fixed something, you are free to send me a pull request.

License
-------

[](#license)

MIT.

See also: [LICENSE](LICENSE).

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance79

Regular maintenance activity

Popularity40

Moderate usage in the ecosystem

Community11

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 97.3% 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 ~377 days

Recently: every ~394 days

Total

9

Last Release

113d ago

Major Versions

v0.1.0 → v1.0.02017-12-06

v1.0.0 → v2.0.02021-03-14

v2.2.0 → v3.0.02024-08-07

v3.0.0 → v4.0.02025-12-15

PHP version history (3 changes)v0.1.0PHP >=7.0

v2.0.0PHP >=8.0

v3.0.0PHP >=8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3715845?v=4)[Nico Verbruggen](/maintainers/nicoverbruggen)[@nicoverbruggen](https://github.com/nicoverbruggen)

---

Top Contributors

[![nicoverbruggen](https://avatars.githubusercontent.com/u/3715845?v=4)](https://github.com/nicoverbruggen "nicoverbruggen (36 commits)")[![mjot](https://avatars.githubusercontent.com/u/1445991?v=4)](https://github.com/mjot "mjot (1 commits)")

---

Tags

fontmultilinephpplaceholder-image

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/nicoverbruggen-image-generator/health.svg)

```
[![Health](https://phpackages.com/badges/nicoverbruggen-image-generator/health.svg)](https://phpackages.com/packages/nicoverbruggen-image-generator)
```

###  Alternatives

[goat1000/svggraph

Generates SVG graphs

135911.1k3](/packages/goat1000-svggraph)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

16653.6k2](/packages/gravatarphp-gravatar)[rsoury/wp-imgix

Rewrites WordPress image URLs to use ImgIX

167.2k](/packages/rsoury-wp-imgix)

PHPackages © 2026

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