PHPackages                             square1/resized - 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. square1/resized

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

square1/resized
===============

On-demand image manipulation service.

2.0.1(3w ago)398.3k↓14.2%4[1 PRs](https://github.com/square1-io/resized-php/pulls)1MITPHPPHP ^8.2CI passing

Since Mar 9Pushed 3w ago9 watchersCompare

[ Source](https://github.com/square1-io/resized-php)[ Packagist](https://packagist.org/packages/square1/resized)[ Docs](https://github.com/square1-io/resized-php)[ RSS](/packages/square1-resized/feed)WikiDiscussions master Synced yesterday

READMEChangelog (6)Dependencies (5)Versions (12)Used By (1)

Resized
=======

[](#resized)

This is the PHP client for resized.co, a realtime image resize manipulation service.

Requires PHP 8.2 or higher.

Install
-------

[](#install)

Via Composer

```
$ composer require square1/resized
```

Usage
-----

[](#usage)

```
    // Initialize and authenticate
    $resized = new \Square1\Resized\Resized('key', 'secret');

    // Override host if applicable
    $resized->setHost('https://img.resized.co');

    // Set the default failover image (used when $url is null, empty, or invalid)
    $resized->setDefaultImage('http://www.example.com/no-image.jpg');

    // Set default options
    $resized->setDefaultOptions(['quality' => 100]);

    // Process image resize. Parameters: ($url, $width, $height, $title, $options)
    // $url and $title accept string or null. Null $url falls back to the default image.
    // $width and $height accept int, string, or null. Null means no constraint on that dimension.
    $img = $resized->process('http://www.example.com/some-image.jpg', '100', '100', 'This is a title');

    // Integer dimensions are also accepted
    $img = $resized->process('http://www.example.com/some-image.jpg', 100, 200);

    // Constrain only width, leave height unconstrained
    $img = $resized->process('http://www.example.com/some-image.jpg', 100);

    // Pass null URL to always use the default image
    $img = $resized->process(null, 100, 200);
```

Testing
-------

[](#testing)

```
$ composer test
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

63

—

FairBetter than 99% of packages

Maintenance95

Actively maintained with recent releases

Popularity36

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~468 days

Recently: every ~514 days

Total

9

Last Release

25d ago

Major Versions

v1.3.0 → 2.0.02026-06-05

PHP version history (4 changes)v1.0PHP ~5.5|~7.0

v1.2.0PHP ~7.2

v1.3.0PHP ~7.2|~8.0

2.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/5a6096b0455d662c5963ed82e1f0968bc4a18bdfedd332f7fd2598480b4c17bd?d=identicon)[conroyp](/maintainers/conroyp)

![](https://www.gravatar.com/avatar/87a3c780c8712d13c47574f6ffc320e9a6c2d368d1b51d4ad53dc5440ab3406d?d=identicon)[ciaranmaher](/maintainers/ciaranmaher)

---

Top Contributors

[![ciaranmaher](https://avatars.githubusercontent.com/u/122523?v=4)](https://github.com/ciaranmaher "ciaranmaher (11 commits)")[![conroyp](https://avatars.githubusercontent.com/u/143244?v=4)](https://github.com/conroyp "conroyp (7 commits)")[![JoseVte](https://avatars.githubusercontent.com/u/3540836?v=4)](https://github.com/JoseVte "JoseVte (4 commits)")[![jeffochoa](https://avatars.githubusercontent.com/u/8247079?v=4)](https://github.com/jeffochoa "jeffochoa (2 commits)")[![GastonGelhorn](https://avatars.githubusercontent.com/u/13986195?v=4)](https://github.com/GastonGelhorn "GastonGelhorn (1 commits)")[![gelhorng](https://avatars.githubusercontent.com/u/225365566?v=4)](https://github.com/gelhorng "gelhorng (1 commits)")

---

Tags

image manipulationsquare1resized

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/square1-resized/health.svg)

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

###  Alternatives

[imagine/imagine

Image processing for PHP

4.5k75.7M397](/packages/imagine-imagine)[avalanche123/imagine-bundle

Image manipulation using Imagine and Twig Filters.

322560.9k7](/packages/avalanche123-imagine-bundle)[rokka/imagine-vips

libvips adapter for imagine

43638.4k7](/packages/rokka-imagine-vips)[orchestra/imagine

Imagine (Wrapper) Component for Laravel

70220.6k3](/packages/orchestra-imagine)[pixelandtonic/imagine

Image processing for PHP

133.5M7](/packages/pixelandtonic-imagine)[ace-of-aces/laravel-image-transform-url

Easy, URL-based image transformations inspired by Cloudflare Images.

17610.6k](/packages/ace-of-aces-laravel-image-transform-url)

PHPackages © 2026

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