bepsvpt/blurhash

A PHP implementation of BlurHash with Laravel integration.

4.0.0 2025-03-16 03:22 UTC

Requires

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

Requires (Dev)

• ergebnis/composer-normalize: ^2.45
• jcupitt/vips: ^2.4
• larastan/larastan: ^3.2
• laravel/pint: ^1.21
• orchestra/testbench: ^6.47 || ^7.53 || ^8.34 || ^9.12 || ^10.1
• phpunit/phpunit: ^9.6 || ^10.5 || ^11.5 || ^12.0

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.0.0

Supported Laravel Version

8.0 ~ 12.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).