janwalenda/spectra

A PHP 7.4+ library for color conversion between HEX, RGB(A), HSL(A) and the perceptually uniform OKLCH color space.

dev-main 2025-11-06 18:49 UTC

Requires (Dev)

• phpunit/phpunit: ^12.4

MIT

• Jan Walenda

README

Spectra is a PHP 7.4+ library for color space conversions between HEX, RGB(A), HSL(A), and the perceptually uniform OKLCH color space.

Installation

Install via Composer:

composer require janwalenda/spectra

Features

• Convert between common web color formats:
  • HEX (#RGB, #RRGGBB, #RRGGBBAA)
  • RGB/RGBA (rgb(r,g,b), rgba(r,g,b,a))
  • HSL/HSLA (hsl(h,s%,l%))
  • OKLCH (oklch(l c h), oklch(l c h / a%))
• Supports transparency (alpha channel)
• Perceptual uniformity through OKLCH
• Calculate contrast colors
• Parse color strings in various formats

Usage

Basic Color Space Conversion

use Janwalenda\Spectra\Converter;

$converter = new Converter();

// Convert HEX to OKLCH
$oklch = $converter->getDynamicOklchColor('#ff0000');
// Result: "oklch(0.6319 0.2789 29.2337)"

// Convert RGB to OKLCH
$oklch = $converter->getDynamicOklchColor('rgb(255, 0, 0)');

// Get contrasting color
$contrast = $converter->getDynamicContrastOklchColor('#ffffff');
// Returns black as OKLCH for white background

Working with Color Objects

use Janwalenda\Spectra\RGB;
use Janwalenda\Spectra\HSL;
use Janwalenda\Spectra\LCH;

// Create RGB color
$rgb = new RGB(255, 0, 0, 0.5);  // Red at 50% opacity

// Parse colors from strings
$rgb = RGB::parseFromString('rgba(255, 0, 0, 0.5)');
$hsl = HSL::parseFromString('hsl(0, 100%, 50%)');
$lch = LCH::parseFromString('oklch(50 20 180)');

Requirements

• PHP 7.4 or higher
• Composer for installation

License

MIT License

Author

Jan Walenda ([e-mail])