PHPackages                             uiarts/proxy-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. uiarts/proxy-image

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

uiarts/proxy-image
==================

Proxy images

1.3.4(3w ago)0176↑22.2%MITPHP

Since Mar 18Pushed 3w agoCompare

[ Source](https://github.com/UI-Arts/proxy-image)[ Packagist](https://packagist.org/packages/uiarts/proxy-image)[ RSS](/packages/uiarts-proxy-image/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)DependenciesVersions (13)Used By (0)

Proxy Image Laravel Package
===========================

[](#proxy-image-laravel-package)

Пакет для проксування та обробки зображень (resize, crop, optimize) через підписані URL.

---

Встановлення
------------

[](#встановлення)

### 1. Додати пакет через Composer

[](#1-додати-пакет-через-composer)

```
composer require uiarts/proxy-image
```

---

### 2. Опублікувати конфіг

[](#2-опублікувати-конфіг)

```
php artisan vendor:publish --tag=proxy-image-config
```

---

### 3. Опублікувати entrypoint (images.php)

[](#3-опублікувати-entrypoint-imagesphp)

```
php artisan vendor:publish --tag=proxy-image-public
```

Після цього файл буде доступний:

```
public/images.php

```

---

Налаштування
------------

[](#налаштування)

В `.env` додай:

```
IMAGES_HMAC_SECRET=your-secret-key
IMAGES_DEFAULT_DISK=your_disk
IMAGES_LOCAL_DISK=your_disk
IMAGES_LOCAL_PREFIX=
IMAGES_S3_DISK=s3
IMAGES_S3_PREFIX=
IMAGES_PICTURE_PLACEHOLDER_MODE=false
IMAGES_RENDERER=gd
IMAGES_LIBVIPS_BINARY=vipsthumbnail
IMAGES_LIBVIPS_MODE=vipsthumbnail
```

Або відредагуй `config/proxy-image.php`.

### Renderer

[](#renderer)

- `IMAGES_RENDERER=gd` — поточний дефолтний рендерер через GD.
- `IMAGES_RENDERER=libvips` — рендерер через `libvips` CLI.
- `IMAGES_LIBVIPS_MODE=vipsthumbnail|thumbnail_source` — режим роботи libvips.
- `IMAGES_LIBVIPS_BINARY` — шлях/назва бінарника для обраного режиму:
    - `vipsthumbnail` для `IMAGES_LIBVIPS_MODE=vipsthumbnail`
    - `vips` для `IMAGES_LIBVIPS_MODE=thumbnail_source`

### Placeholder mode (picsum)

[](#placeholder-mode-picsum)

Коли `IMAGES_PICTURE_PLACEHOLDER_MODE=true`, методи `ProxyImage::picture(...)` і `ProxyImage::singleUrl(...)` віддають лінки на `https://picsum.photos/{width}/{height}`. Розміри беруться з `sizes` для кожного брейкпоінта. Якщо висота `a`, використовується `width / 2`. Це зменшує навантаження на локальну машину під час розробки.

---

Налаштування Nginx
------------------

[](#налаштування-nginx)

Додай у конфіг:

```
location ^~ /i/ {
    include fastcgi_params;

    fastcgi_pass php-fpm:9000;

    fastcgi_param SCRIPT_FILENAME $document_root/images.php;
    fastcgi_param SCRIPT_NAME /images.php;
    fastcgi_param REQUEST_URI $request_uri;
    fastcgi_param PHP_VALUE "error_log=/var/log/nginx/application_php_errors.log";
    add_header X-Images-Entrypoint 1 always;
}

if (!-e $request_filename) {
    rewrite ^.*$ /index.php last;
}
```

---

Формат URL
----------

[](#формат-url)

```
/i/{signature}/{ops}/{encoded}.{ext}

```

---

Приклад URL
-----------

[](#приклад-url)

```
https://example.com/i/{signature}/w:800/dXBsb2Fkcy90ZXN0LmpwZw.jpg

```

Приклад Використання
--------------------

[](#приклад-використання)

```
{!!
\UIArts\ProxyImage\Facades\ProxyImage::picture(
    pictures: 'uploads/image.jpg',
    sizes: [
        'mobile' => [300, 'a'], // [(int)width, (int|string)height] height - може бути або int або стрінг, але тільки "a", що означає auto
        'tablet' => [300, 'a'],
        'desktop' => [800, 'a'],
    ],
    class: 'picture-wrap', // class для
    attributes: [
        'mode' => 'fit', // fit, fill
        'quality' => 85,
        'densities' => [1, 2],
        'alt' => 'Some alt',
        'title' => 'Some title',
        'class' => 'img-fluid', // class для
        'data-zoom' => 'uploads/image.jpg',
        'data-error-src' => 'uploads/image.jpg',
        'loading' => 'lazy',
        'lazyStrategy' => 'observer', // observer, manual
        'fetchPriority' => 'high', // high, low, auto
    ],
)
!!}

```

Headless JSON (picture data)
----------------------------

[](#headless-json-picture-data)

Структуровані дані для `` можна отримати без HTML:

```
\UIArts\ProxyImage\Facades\ProxyImage::pictureData(
    pictures: 'uploads/image.jpg',
    sizes: [
        'mobile' => [300, 'a'],
        'tablet' => [300, 'a'],
        'desktop' => [800, 'a'],
    ],
    attributes: [
        'mode' => 'fit',
        'quality' => 85,
        'densities' => [1, 2],
        'formats' => ['avif', 'jpg'],
        'alt' => 'Some alt',
        'lazyStrategy' => 'observer',
    ],
);
```

### Lazy strategy

[](#lazy-strategy)

- `lazyStrategy=observer` — дефолтна поведінка для `loading=lazy`: пакет віддає `data-src`/`data-srcset` і автоматично додає клас `lazy`.
- `lazyStrategy=manual` — пакет віддає deferred markup (`data-src`, `data-srcset`, placeholder у `src`), але **не** додає клас `lazy`. Це режим для кастомного тригера, наприклад hover, click, slider change або ручного `LazyLoad.load(...)`.

Формат відповіді:

```
[
    'mode' => 'proxy', // proxy|bypass|placeholder
    'img' => [
        'src' => '/i/...',
        'srcset' => '/i/... 1x, /i/... 2x',
        'alt' => 'Some alt',
        'title' => 'Some title',
        'width' => 800,
        'height' => 'auto',
    ],
    'sources' => [
        [
            'type' => 'image/avif',
            'media' => '(min-width: 1200px)',
            'srcset' => '/i/... 1x, /i/... 2x',
        ],
    ],
]
```

Приклад для Vue:

```

defineProps({
  data: { type: Object, required: true }
});

```

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance94

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.7% 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 ~6 days

Total

12

Last Release

27d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b7f6f4a286ba2135763d138e49c2007709f8e5c0144795dc4259fa8bb73b87a7?d=identicon)[rom\_moz](/maintainers/rom_moz)

---

Top Contributors

[![AlexHrabar](https://avatars.githubusercontent.com/u/34456105?v=4)](https://github.com/AlexHrabar "AlexHrabar (11 commits)")[![IgorUsoltsev](https://avatars.githubusercontent.com/u/5917245?v=4)](https://github.com/IgorUsoltsev "IgorUsoltsev (1 commits)")

### Embed Badge

![Health badge](/badges/uiarts-proxy-image/health.svg)

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

###  Alternatives

[goat1000/svggraph

Generates SVG graphs

133890.0k3](/packages/goat1000-svggraph)[imagekit/imagekit

PHP library for Imagekit

46877.3k10](/packages/imagekit-imagekit)[gravatarphp/gravatar

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

12644.1k2](/packages/gravatarphp-gravatar)

PHPackages © 2026

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