bepsvpt/blurhash

A PHP implementation of BlurHash with Laravel integration.

4.1.0 2026-03-17 22:56 UTC

Requires

• php: ^8.0
• ext-exif: *
• illuminate/support: ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0

Requires (Dev)

• ergebnis/composer-normalize: ^2.48
• jcupitt/vips: ^2.5
• larastan/larastan: ^3.7
• laravel/pint: ^1.25
• orchestra/testbench: ^6.47 || ^7.55 || ^8.36 || ^9.15 || ^10.6 || ^11.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^9.6 || ^10.5 || ^11.5 || ^12.4

Suggests

• ext-ffi: Required to use php-vips driver.
• ext-gd: Required to use GD driver.
• ext-imagick: Required to use Imagick driver.
• jcupitt/vips: Required to use php-vips driver.

MIT

• bepsvpt

• laravel
• blurhash

README

A PHP implementation of BlurHash with Laravel integration.

BlurHash is a compact representation of a placeholder for an image.

Nr8%YLkDR4j[aej]NSaznzjuk9ayR3jYofayj[f6

• Version
• Installation
• Usage
• Changelog
• Upgrade
• License

Version

4.1.0

Supported Laravel Version

8.0 ~ 13.x

Installation

Install using composer

composer require bepsvpt/blurhash

Publish config file

php artisan vendor:publish --provider="Bepsvpt\Blurhash\BlurHashServiceProvider"

Set up config file on config/blurhash.php

Done!

Usage

Facade

BlurHash::encode($path);

$file can be UploadedFile or a file path string.

app helper function

app('blurhash')
  ->setComponentX(7)
  ->setComponentY(4)
  ->setMaxSize(96)
  ->encode(request('file'));

Changelog

Please see CHANGELOG for details.

Upgrade

Please see UPGRADE for details.

License

BlurHash is licensed under The MIT License (MIT).