Packagist · #3810 most downloaded on Packagist

ozdemirburak/iris

4.1.22.0M downloads/moozdemirburak/iris ↗New releases in your daily digest, changelog included.

PHP library for color manipulation and conversion.

Last release 2 months ago
03 Aug 2026
Release timing varies
gaps range from 2 weeks to 2.8 years
Some releases are documented
notes for 10 of 21 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
21 releases · first in 2017

Release timeline

21 releases since 2017

2017201920212023

Releases

4.1.23 Aug 2026
Clamp negative alpha values in AlphaTrait by @gaoflow in #53
What's Changed

Clamp negative alpha values in AlphaTrait by @gaoflow in #53

New Contributors

@gaoflow made their first contribution in #53

Full Changelog: 4.1.1...4.1.2
Open source →
4.1.17 Jan 2026
Fixes incorrect param type for PHPStan.
Fixes incorrect param type for PHPStan.
Open source →

One column per quarter.

Added gradient() method for generating color scales ( #51 , #50 )

Added gradient() method for generating color scales (#51, #50)

Supports two-color gradients: $colorA->gradient($colorB, $steps)
Supports multi-color gradients with pivots: $colorA->gradient([$colorB, $colorC], $steps)
Works with all color types (Hex, RGB, HSL, HSV, CMYK, OKLCH, RGBA, HSLA)
Returns array of colors matching the starting color type
Added comprehensive tests for all color types and edge cases

Open source →

4.0.12 Dec 2025

Fixed OKLCH parsing, accepting both comma and space separated formats.

Support CSS Color Level 4 space-separated syntax: oklch(40.1% 0.123 21.57)
Continue supporting comma-separated syntax: oklch(70%, 0.15, 150)
Alpha values in input are parsed but ignored (e.g., oklch(50% 0.1 180 / .5))

Open source →

4.0.02 Dec 2025

A major release bringing modern PHP support and a new color space. This version requires PHP 8.1+ and introduces OKLCH, a perceptually uniform color s

A major release bringing modern PHP support and a new color space. This version requires PHP 8.1+ and introduces OKLCH, a perceptually uniform color space, which is ideal for creating accessible color palettes and smooth gradients.

Breaking Changes

Minimum PHP version is now 8.1
Removed Travis CI configuration
Removed EditorConfig and PHP CodeSniffer

New Features

OKLCH Color Space: Added full support for the perceptually uniform OKLCH color format
Parse OKLCH strings: new Oklch('oklch(70%, 0.15, 150)')
Convert any color to OKLCH: $hex->toOklch()
Convert OKLCH to all other formats (Hex, RGB, HSL, etc.)
Factory support for OKLCH strings

Bug Fixes

Fixed RGBA to HEXA conversion preserving original RGB values (#37)
Fixed HSLA to HEXA conversion preserving original alpha value (#48)

Improvements

Updated PHPUnit to ^10.5|^11.0
Converted all test annotations to PHP 8 attributes

Currently Supported Formats

Hex, Hexa, RGB, RGBA, HSL, HSLA, HSV, CMYK, OKLCH

Open source →

3.1.122 Feb 2023

Using float instead of int to avoid warnings @jaulz

Using float instead of int to avoid warnings @jaulz

Open source →

3.1.08 Feb 2023

Use float instead of int to avoid warnings @jaulz

Use float instead of int to avoid warnings @jaulz
Fixes for issues #39

Open source →

3.0.08 Feb 2022

Remove PHP 7 support, will only support PHP 8

Remove PHP 7 support, will only support PHP 8
Added type hinting and return type declarations
Made BaseColor::back() and BaseColor::getColorModelName() public @rv1971
Use non-locale aware output for the alpha value @Jako
Updated .gitignore, and some code refactoring @kudashevs

Open source →

2.5.013 Feb 2022

Made BaseColor::back() and BaseColor::getColorModelName() public, added mixInHsv() @rv1971

Made BaseColor::back() and BaseColor::getColorModelName() public, added mixInHsv() @rv1971
Use non-locale aware output for the alpha value @Jako
Updated .gitignore, and some code refactoring @kudashevs

Open source →

2.4.05 Oct 2021

Added new Hexa class, fixes issue #28 , thanks to @amnuts .

Added new Hexa class, fixes issue #28, thanks to @amnuts.

Open source →

2.3.130 Jan 2021