PHPackages                             imgsrc/laravel - 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. imgsrc/laravel

ActiveLibrary

imgsrc/laravel
==============

The official Laravel client for ImgSrc — real-time image processing, uploads, and delivery for Laravel apps.

00PHP

Since Jul 18Pushed 1mo agoCompare

[ Source](https://github.com/imgsrcdev/laravel)[ Packagist](https://packagist.org/packages/imgsrc/laravel)[ RSS](/packages/imgsrc-laravel/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

imgsrc/laravel
==============

[](#imgsrclaravel)

The official Laravel client for **ImgSrc** — real-time image processing, uploads, and delivery, laser-focused on Laravel.

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

[](#installation)

```
composer require imgsrc/laravel
```

Add your credentials to `.env`:

```
# Where your images are served from (your source subdomain or custom domain)
IMGSRC_URL=https://my-app.imgsrc.test

# Only needed when your source has Secure URLs enabled
IMGSRC_TOKEN=

# Management API (uploads, deletes, purges) — from your ImgSrc dashboard
IMGSRC_API_URL=https://imgsrc.test
IMGSRC_API_KEY=imgsrc_xxxxxxxxxxxx
IMGSRC_SOURCE=my-app
```

Optionally publish the config:

```
php artisan vendor:publish --tag=imgsrc-config
```

Building URLs
-------------

[](#building-urls)

```
use ImgSrc\Laravel\Facades\ImgSrc;

ImgSrc::url('photos/hero.jpg', ['w' => 1200, 'h' => 630, 'fit' => 'crop']);
// => https://my-app.imgsrc.test/photos/hero.jpg?auto=format&fit=crop&h=630&w=1200

// Responsive srcset (width descriptors)
ImgSrc::srcset('photos/hero.jpg', ['fit' => 'crop', 'ar' => '16:9']);
```

When `IMGSRC_TOKEN` is set, every URL is signed automatically (`s=` parameter) and unsigned URLs are rejected by the server.

The Blade component
-------------------

[](#the-blade-component)

```

```

Renders an `` with `src`, a width-based `srcset`, `sizes`, lazy loading, and async decoding. Pass `:responsive="false"` to skip the srcset, or extra rendering parameters with `:params="['blur' => 40, 'sat' => -100]"`.

Uploads & asset management
------------------------------

[](#uploads--asset-management)

```
// Upload (from a path or an UploadedFile)
ImgSrc::upload($request->file('avatar'), path: 'avatars/'.$user->id.'.jpg', overwrite: true);

// List / search
ImgSrc::assets(folder: 'avatars');
ImgSrc::asset('avatars/1.jpg');

// Delete
ImgSrc::delete('avatars/1.jpg');

// Index files already in your bucket
ImgSrc::sync('legacy-folder');

// Purge cached renders after replacing a file
ImgSrc::purge('avatars/1.jpg');   // one asset
ImgSrc::purge();                  // entire source
```

Rendering parameters
--------------------

[](#rendering-parameters)

All ImgSrc rendering parameters use the familiar imgix names: `w`, `h`, `ar`, `fit` (`clip|crop|fill|fillmax|max|min|scale`), `crop` (incl. `focalpoint`, `entropy`), `dpr`, `rect`, `fm` (`jpg|png|gif|webp|avif`), `q`, `auto=format,compress`, `bri`, `con`, `sat`, `hue`, `exp`, `gam`, `vib`, `sharp`, `usm`, `blur`, `px`, `mono`, `sepia`, `invert`, `rot`, `flip`, `bg`, `pad`, `border`, `corner-radius`, `trim`, `mark*`, `txt*`, `preset`, and `dl`.

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance60

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

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

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2907450?v=4)[devdojo](/maintainers/devdojo)[@DevDojo](https://github.com/DevDojo)

---

Top Contributors

[![tnylea](https://avatars.githubusercontent.com/u/601261?v=4)](https://github.com/tnylea "tnylea (1 commits)")

### Embed Badge

![Health badge](/badges/imgsrc-laravel/health.svg)

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

PHPackages © 2026

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