PHPackages                             xaraya/images - 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 &amp; Media](/categories/media)
4. /
5. xaraya/images

ActiveXaraya-module[Image &amp; Media](/categories/media)

xaraya/images
=============

Handles image manipulation with resizing/cropping/scaling/rotating and various filters

2.9.4(8mo ago)01431GPL-2.0-or-laterPHP

Since Apr 15Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/xaraya-modules/images)[ Packagist](https://packagist.org/packages/xaraya/images)[ Docs](https://github.com/xaraya-modules/images)[ RSS](/packages/xaraya-images/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (20)Used By (1)

Overview
--------

[](#overview)

### What is it?

[](#what-is-it)

*Images is a Xaraya Utility Module.* It is currently responsible for basic image manipulation, including the following:

- Resize Image files
- Crop image files
- Rotate image files
- Add text to an image file (think buttons here...)
- ...

### How to use it?

[](#how-to-use-it)

#### Image Tags

[](#image-tags)

&lt;xar:image-resize src="FILEID" \[width="(\[0-9\]+)(px|%)" \[height="(\[0-9\]+)(px|%)"\]\] \[constrain="0|1"\] label="TEXT" /&gt;

The IMAGE tag is useful for displaying (cached) images at different proportions. Images are resized according to the height/width values you specify with the resulting image cached for faster displaying later on. Note: Any other attribute not listed will be passed directly on to the resultant &lt;img&gt; tag.

Examples:

Resize an image's width while keeping the proportions:

&lt;xar:image-resize src="23" width="92px" constrain="1" label="my logo" /&gt;

Apply some pre-defined image processing (e.g. watermark):

&lt;xar:image-resize src="test/image.jpg" setting="JPEG 800 x 600" label="my image" /&gt;

### Included Blocks

[](#included-blocks)

There are no included blocks.

### Privileges

[](#privileges)

The Images module only has the Admin privilege to assign. You will need this level if you want to set the general settings for the Images module. The Images module interacts with the uploads module, so make sure you set appropriate levels for that module as well. Take special note on the approval of files in the uploads module. Only files that have been approved will normally be accessible by standard users, or you need to assign them the EDIT privilege for the uploads.

### Upgrade from version 1.0.0

[](#upgrade-from-version-100)

The naming convention for derivative images has changed since version 1.0.0. So you can delete the old derivative images, and new derivative images will be created as needed in the same directory...

### Further Information

[](#further-information)

Extended information about this module can be found at [Xaraya Extension and Releases](http://www.xaraya.com/index.php/release/152.html "Images Module - Xaraya Extension 152").

- Click on Version History tab at the bottom to get the latest release information.
- Related tutorials and documentation on Images found at [Xaraya Documentation.](http://www.xaraya.com/index.php/keywords/images/ "Related documentation on Images")

\*\* Images module - Overview\*\*
 Version 1.1.0

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance61

Regular maintenance activity

Popularity10

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 59.8% 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 ~74 days

Recently: every ~13 days

Total

19

Last Release

246d ago

Major Versions

1.9.0 → 2.5.72025-01-12

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1447115?v=4)[Mike's Pub](/maintainers/mikespub)[@mikespub](https://github.com/mikespub)

---

Top Contributors

[![mikespub](https://avatars.githubusercontent.com/u/1447115?v=4)](https://github.com/mikespub "mikespub (76 commits)")[![mrvdb](https://avatars.githubusercontent.com/u/73067?v=4)](https://github.com/mrvdb "mrvdb (50 commits)")[![bmcg](https://avatars.githubusercontent.com/u/1027483?v=4)](https://github.com/bmcg "bmcg (1 commits)")

### Embed Badge

![Health badge](/badges/xaraya-images/health.svg)

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

###  Alternatives

[goat1000/svggraph

Generates SVG graphs

135931.0k3](/packages/goat1000-svggraph)[stefangabos/zebra_image

A single-file, lightweight PHP library designed for efficient image manipulation featuring methods for modifying images and applying filters

138121.6k7](/packages/stefangabos-zebra-image)[treinetic/imageartist

ImageArtist is a php gd Wrapper which makes Image manipulation insanely easy, we introduce ImageArtist as Photoshop for php

8783.2k](/packages/treinetic-imageartist)[johncarter/filament-focal-point-picker

An image focal point picker for Filament Admin.

4431.7k1](/packages/johncarter-filament-focal-point-picker)[yk/laravel-ocr

A wrapper for gocr.

1356.6k](/packages/yk-laravel-ocr)

PHPackages © 2026

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