PHPackages                             kakposoe/laravel-placeholder-image - 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. kakposoe/laravel-placeholder-image

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

kakposoe/laravel-placeholder-image
==================================

A laravel placeholder image

v1.0(6y ago)3712[3 issues](https://github.com/kakposoe/laravel-placeholder-image/issues)MITPHPPHP >=7.0CI failing

Since Dec 2Pushed 6y ago1 watchersCompare

[ Source](https://github.com/kakposoe/laravel-placeholder-image)[ Packagist](https://packagist.org/packages/kakposoe/laravel-placeholder-image)[ RSS](/packages/kakposoe-laravel-placeholder-image/feed)WikiDiscussions master Synced yesterday

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Laravel Placeholder Image
=========================

[](#laravel-placeholder-image)

[![Build Status](https://camo.githubusercontent.com/ef6170794f85fcd740e733e1f77c8dd90a08edf3ee7a76e8b943f40a15efe3a0/68747470733a2f2f7472617669732d63692e6f72672f6b616b706f736f652f6c61726176656c2d706c616365686f6c6465722d696d6167652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/kakposoe/laravel-placeholder-image)[![StyleCI](https://camo.githubusercontent.com/c512ac60c9009004e5eda7db46d914da6bd6e62eb01536a28193aa078a16ce6f/68747470733a2f2f7374796c6563692e696f2f7265706f732f3138393235383433362f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/189258436)

A convenient laravel facade which returns a placeholder image url.

- [Installation](#installation)
- [Register Plugin (Laravel 5.5 and below)](#register-service-provider)
- [How to use](#how-to-use)
- [Other image types](#other-image-types)
- [A note about production envs](#a-note-about-production-environments)

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

[](#installation)

Install via composer

```
composer require kakposoe/laravel-placeholder-image
```

### Register Service Provider

[](#register-service-provider)

If you use Laravel < 5.5, Add service provider to `config/app.php` in `providers` section

```
Kakposoe\LaravelViewGenerator\LaravelViewGeneratorServiceProvider::class,
```

### Register Facade

[](#register-facade)

If you use Laravel < 5.5, register package facade in `config/app.php` in `aliases` section

```
Kakposoe\LaravelPlaceholderImage\Facades\LaravelPlaceholderImage::class,
```

### Publish Configuration File

[](#publish-configuration-file)

```
php artisan vendor:publish --provider="Kakposoe\LaravelPlaceholderImage\ServiceProvider" --tag="config"
```

How to use
----------

[](#how-to-use)

You can get a placeholder image url within your blade templates by adding:

```
{{ PlaceholderImage::get($width = null, $height = null) }}
```

By default, images will be returned as a 600px x 400px image.

To change the dimensions of the image, simply add the `$width` and `$height` like so:

```
{{ PlaceholderImage::get(300, 300) }}
```

Other image types
-----------------

[](#other-image-types)

There are several different types of image at your disposal:

### Profile Image

[](#profile-image)

To get a profile image placeholder:

```

```

### Icon image

[](#icon-image)

You are able to create a placeholder image with a font-awesome icon in the middle:

```

```

**Note:** By default, the `fa-image` icon will be returned.

### Blurry image

[](#blurry-image)

To return a blurry image:

```

```

### Keyword search

[](#keyword-search)

You can return a placeholder url based on a keyword:

```

```

### Placeholder with image dimensions

[](#placeholder-with-image-dimensions)

An placeholder image url which has the image dimensions can be returned using the `::dimensions()` method:

```

```

A note about production environments
------------------------------------

[](#a-note-about-production-environments)

As these are placeholder images, it is assumed that these should not to be used within production environments.

All placeholder images used in production will be replaced with an `::icon()` placeholder image, avoiding showing inappropriate images and the impression that the image could not be found.

Credits
-------

[](#credits)

- [Kelvin Akposoe](https://github.com/kakposoe)

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.2% 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

Unknown

Total

1

Last Release

2353d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3f68a614ebb68f585a9722fdff7781d93b7d66ada6ded72c223e7b414a112f67?d=identicon)[kakposoe](/maintainers/kakposoe)

---

Top Contributors

[![kakposoe](https://avatars.githubusercontent.com/u/7933597?v=4)](https://github.com/kakposoe "kakposoe (20 commits)")[![christian-melon](https://avatars.githubusercontent.com/u/249279714?v=4)](https://github.com/christian-melon "christian-melon (1 commits)")

---

Tags

laravelimageplaceholder

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kakposoe-laravel-placeholder-image/health.svg)

```
[![Health](https://phpackages.com/badges/kakposoe-laravel-placeholder-image/health.svg)](https://phpackages.com/packages/kakposoe-laravel-placeholder-image)
```

###  Alternatives

[intervention/image-laravel

Laravel Integration of Intervention Image

1496.5M102](/packages/intervention-image-laravel)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k23](/packages/bkwld-croppa)[spescina/imgproxy

An image proxy for Laravel

201.3k](/packages/spescina-imgproxy)

PHPackages © 2026

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