PHPackages renfordt/colors - 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. [Utility & Helpers](/categories/utility) 4. / 5. renfordt/colors ActiveLibrary[Utility & Helpers](/categories/utility) renfordt/colors =============== A php library to convert and modify colors. v2.0.0(4mo ago)14.4k↓33.3%[1 PRs](https://github.com/renfordt/colors/pulls)1MITPHPPHP ^8.4CI passing Since Aug 6Pushed 4mo ago1 watchersCompare [ Source](https://github.com/renfordt/colors)[ Packagist](https://packagist.org/packages/renfordt/colors)[ RSS](/packages/renfordt-colors/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)Dependencies (8)Versions (8)Used By (1) 🎨 renfordt/colors ================= [](#-renfordtcolors) [![Badge](https://camo.githubusercontent.com/f7c54ebedae5ab4472618eefcdb51a8a5bc0bd313928254e0d582daa8485a9af/687474703a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d72656e666f7264742f636f6c6f72732d626c75652e737667)](https://github.com/renfordt/colors)[![Packagist Version](https://camo.githubusercontent.com/e9c9f577ab548ee4b57b256f8472ecf7560e0a9765a9956db93face001546f01/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72656e666f7264742f636f6c6f7273)](https://packagist.org/packages/renfordt/colors/)[![Packagist PHP Version](https://camo.githubusercontent.com/19bb0741112e00e430a134af30ce59348564248bff9ed2f4fc1136ceeaae8f82/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f72656e666f7264742f636f6c6f72732f706870)](https://camo.githubusercontent.com/19bb0741112e00e430a134af30ce59348564248bff9ed2f4fc1136ceeaae8f82/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f72656e666f7264742f636f6c6f72732f706870)[![GitHub License](https://camo.githubusercontent.com/914fb3cc12acfcdd472ebf569be206187adce862e7629673fdd8636e87ba7f01/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f72656e666f7264742f636f6c6f7273)](https://camo.githubusercontent.com/914fb3cc12acfcdd472ebf569be206187adce862e7629673fdd8636e87ba7f01/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f72656e666f7264742f636f6c6f7273)[![GitHub Actions Workflow Status](https://camo.githubusercontent.com/348d7e82c3dd3d20305b1cd0fcc1470d159e386a6d3ad3dd2155064c484a465a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72656e666f7264742f636f6c6f72732f74657374732e796d6c3f6c6f676f3d676974687562)](https://camo.githubusercontent.com/348d7e82c3dd3d20305b1cd0fcc1470d159e386a6d3ad3dd2155064c484a465a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72656e666f7264742f636f6c6f72732f74657374732e796d6c3f6c6f676f3d676974687562)[![Code Coverage](https://camo.githubusercontent.com/275292072d913089f1e441bdadffbc54ae51c0c0116c360a5e1c84d4ccde2988/68747470733a2f2f716c74792e73682f67682f72656e666f7264742f70726f6a656374732f636f6c6f72732f636f7665726167652e737667)](https://qlty.sh/gh/renfordt/projects/colors)[![Maintainability](https://camo.githubusercontent.com/d48f12048569df03aacf71b30dcad0f01650718cc54fac6520eda2c2e15ce00b/68747470733a2f2f716c74792e73682f67682f72656e666f7264742f70726f6a656374732f636f6c6f72732f6d61696e7461696e6162696c6974792e737667)](https://qlty.sh/gh/renfordt/projects/colors) A modern PHP library for effortless color manipulation and conversion. Convert between **Hex**, **RGB**, **HSL**, **HSV**, and **RAL** color formats with ease. > πŸš€ **Version 2.0** - Now powered by PHP 8.4 property hooks for a cleaner, more intuitive API! --- ✨ Features ---------- [](#-features) - πŸ”„ **Universal Conversion** - Seamlessly convert between all major color formats - 🎯 **Type-Safe** - Full type declarations with PHPStan level max compliance - ⚑ **Modern PHP** - Leverages PHP 8.4 property hooks and latest language features - 🎨 **RAL Support** - Complete RAL color system with closest color matching - πŸ” **Auto-Validation** - Automatic range clamping ensures valid color values - πŸ“¦ **Zero Dependencies** - Only requires `renfordt/clamp` utility --- πŸ“¦ Installation -------------- [](#-installation) ``` composer require renfordt/colors ``` ### Requirements [](#requirements) - **PHP 8.4** or higher - **Composer** --- πŸš€ Quick Start ------------- [](#-quick-start) ### Creating Colors [](#creating-colors) ``` use Renfordt\Colors\{HexColor, RGBColor, HSLColor, HSVColor, RALColor}; // Hex colors - with or without # prefix $hex = HexColor::create('#FF5733'); $hex = HexColor::create('FF5733'); // RGB colors - values from 0-255 $rgb = RGBColor::create([255, 87, 51]); // HSL colors - hue: 0-360, saturation/lightness: 0.0-1.0 $hsl = HSLColor::create([9, 1.0, 0.6]); // HSV colors - hue: 0-360, saturation/value: 0.0-1.0 $hsv = HSVColor::create([9, 0.8, 1.0]); // RAL colors - standard RAL codes $ral = RALColor::create(3020); ``` --- 🎨 Working with Colors (v2.0) ---------------------------- [](#-working-with-colors-v20) ### Direct Property Access [](#direct-property-access) The new property hooks API makes working with colors intuitive and clean: ``` // RGB - direct component access $color = RGBColor::create([255, 100, 50]); echo $color->red; // 255 echo $color->green; // 100 echo $color->blue; // 50 // Modify individual components (automatically clamped) $color->red = 200; $color->green = 300; // Automatically clamped to 255 $color->blue = -10; // Automatically clamped to 0 // HSL - access hue, saturation, lightness $hsl = HSLColor::create([180, 0.5, 0.7]); echo $hsl->hue; // 180 echo $hsl->saturation; // 0.5 echo $hsl->lightness; // 0.7 $hsl->lightness = 0.9; // Adjust lightness // HSV - access hue, saturation, value $hsv = HSVColor::create([240, 0.8, 0.6]); echo $hsv->hue; // 240 echo $hsv->saturation; // 0.8 echo $hsv->value; // 0.6 // Hex - get hex value with # $hex = HexColor::create('FF5733'); echo $hex->hex; // #FF5733 // RAL - access RAL code $ral = RALColor::create(3020); echo $ral->ral; // 3020 ``` ### Array Access (Still Available) [](#array-access-still-available) For batch operations, array methods remain available: ``` $rgb = RGBColor::create([255, 100, 50]); [$r, $g, $b] = $rgb->getRGB(); // [255, 100, 50] $hsl = HSLColor::create([180, 0.5, 0.7]); [$h, $s, $l] = $hsl->getHSL(); // [180, 0.5, 0.7] $hsv = HSVColor::create([240, 0.8, 0.6]); [$h, $s, $v] = $hsv->getHSV(); // [240, 0.8, 0.6] ``` --- πŸ”„ Converting Between Formats ---------------------------- [](#-converting-between-formats) All color formats can be converted to any other format: ``` $hex = HexColor::create('#FF5733'); // Convert to any format $rgb = $hex->toRGB(); $hsl = $hex->toHSL(); $hsv = $hex->toHSV(); // Chain conversions $finalColor = HexColor::create('#FF5733') ->toRGB() ->toHSL() ->toHex(); // Precision control for HSL/HSV $hsl = $rgb->toHSL(precision: 2); // Round to 2 decimal places ``` ### Conversion Matrix [](#conversion-matrix) β†’ Hexβ†’ RGBβ†’ HSLβ†’ HSV**Hex**-βœ…βœ…βœ…**RGB**βœ…-βœ…βœ…**HSL**βœ…βœ…-βœ…**HSV**βœ…βœ…βœ…-**RAL**βœ…βœ…βœ…βœ…--- 🎯 Advanced Features ------------------- [](#-advanced-features) ### Color Utilities (HSL) [](#color-utilities-hsl) ``` $color = HSLColor::create([200, 0.6, 0.5]); // Brighten by 20% (default: 10%) $color->brighten(20); // Darken by 15% $color->darken(15); // Access the adjusted lightness echo $color->lightness; // Automatically clamped to 0.0-1.0 ``` ### Hex String Formatting [](#hex-string-formatting) ``` $hex = HexColor::create('FF5733'); // Get with hash (using property) echo $hex->hex; // #FF5733 // Get with/without hash (using method for control) echo $hex->getHexStr(true); // #FF5733 echo $hex->getHexStr(false); // FF5733 // String conversion echo (string) $hex; // #FF5733 ``` ### RAL Color Matching [](#ral-color-matching) Find the closest RAL color to any hex value: ``` $ral = RALColor::create(3020); $customHex = HexColor::create('#FF5500'); // Find closest RAL color $closest = $ral->findClosestColor($customHex); echo $closest->ral; // Returns the nearest RAL code ``` --- πŸ“š API Reference --------------- [](#-api-reference) ### RGBColor [](#rgbcolor) ``` // Properties (with automatic validation) $rgb->red // int (0-255) $rgb->green // int (0-255) $rgb->blue // int (0-255) // Methods $rgb->getRGB() // array $rgb->toHex() // HexColor $rgb->toHSL($precision = 4) // HSLColor $rgb->toHSV($precision = 4) // HSVColor ``` ### HexColor [](#hexcolor) ``` // Properties $hex->hex // string (with # prefix) // Methods $hex->getHexStr($withHash = true) // string $hex->toRGB() // RGBColor $hex->toHSL($precision = 4) // HSLColor $hex->toHSV($precision = 4) // HSVColor ``` ### HSLColor [](#hslcolor) ``` // Properties (with automatic validation) $hsl->hue // int (0-360) $hsl->saturation // float (0.0-1.0) $hsl->lightness // float (0.0-1.0) // Methods $hsl->getHSL() // array{int, float, float} $hsl->toHex() // HexColor $hsl->toRGB() // RGBColor $hsl->brighten($amount = 10) // void $hsl->darken($amount = 10) // void ``` ### HSVColor [](#hsvcolor) ``` // Properties (with automatic validation) $hsv->hue // int (0-360) $hsv->saturation // float (0.0-1.0) $hsv->value // float (0.0-1.0) // Methods $hsv->getHSV() // array{int, float, float} $hsv->toHex() // HexColor $hsv->toRGB() // RGBColor ``` ### RALColor [](#ralcolor) ``` // Properties $ral->ral // int (RAL code) // Methods $ral->toHex() // HexColor $ral->toRGB() // RGBColor $ral->toHSL() // HSLColor $ral->toHSV() // HSVColor $ral->findClosestColor(HexColor $hex) // RALColor|null ``` --- πŸ”§ Migration from v1.x to v2.0 ----------------------------- [](#-migration-from-v1x-to-v20) Version 2.0 introduces **breaking changes** with a cleaner, modern API using property hooks. ### What Changed? [](#what-changed) **Removed Methods:** - ❌ `setRGB()`, `getRed()`, `getGreen()`, `getBlue()` - ❌ `setHexStr()` - ❌ `setHue()`, `getHue()`, `setSaturation()`, `getSaturation()`, etc. - ❌ `toArray()` (use `getRGB()` instead) **New in v2.0:** - βœ… Direct property access with automatic validation - βœ… Property hooks ensure values stay in valid ranges - βœ… Cleaner, more intuitive API ### Migration Examples [](#migration-examples) ``` // ❌ Old way (v1.x) $rgb = RGBColor::create([255, 0, 0]); $rgb->setRGB([0, 255, 0]); $red = $rgb->getRed(); $array = $rgb->toArray(); $hsl->setLightness(0.7); $lightness = $hsl->getLightness(); // βœ… New way (v2.0) $rgb = RGBColor::create([255, 0, 0]); $rgb->red = 0; $rgb->green = 255; $rgb->blue = 0; $red = $rgb->red; $array = $rgb->getRGB(); $hsl->lightness = 0.7; $lightness = $hsl->lightness; ``` --- πŸ§ͺ Development ------------- [](#-development) ### Running Tests [](#running-tests) ``` # Run all tests composer test # Individual test suites composer test:unit # PHPUnit tests composer test:types # PHPStan static analysis composer test:lint # Code style check composer test:refacto # Rector refactoring check ``` ### Code Quality [](#code-quality) ``` # Format code composer lint # Apply Rector refactoring composer refacto ``` --- 🀝 Contributing -------------- [](#-contributing) Contributions are welcome! Please: 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request Please ensure: - βœ… All tests pass (`composer test`) - βœ… Code follows PSR-12 standards - βœ… PHPStan level max compliance - βœ… New features include tests --- πŸ“„ License --------- [](#-license) This package is open-sourced software licensed under the [MIT license](LICENSE). --- πŸ™ Credits --------- [](#-credits) Developed and maintained by [Jannik Renfordt](https://github.com/renfordt). --- **[Documentation](https://github.com/renfordt/colors)** β€’ **[Report Bug](https://github.com/renfordt/colors/issues)** β€’ **[Request Feature](https://github.com/renfordt/colors/issues)** Made with ❀️ using PHP 8.4 ### Health Score 45 β€” FairBetter than 92% of packages Maintenance73 Regular maintenance activity Popularity23 Limited adoption so far Community9 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~98 days Recently: every ~105 days Total 6 Last Release 149d ago Major Versions v1.0.4 β†’ v2.0.02025-12-13 PHP version history (3 changes)v1.0.0PHP ^8.1 v1.0.3PHP ^8.2 v2.0.0PHP ^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/1edb79f2a1fcd61016ec9a5b65183e1f6e7852a4b1f9a5bd6f69c6160366f22c?d=identicon)[renfordt](/maintainers/renfordt) --- Top Contributors [![renfordt](https://avatars.githubusercontent.com/u/699163?v=4)](https://github.com/renfordt "renfordt (129 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Rector Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/renfordt-colors/health.svg) ``` [![Health](https://phpackages.com/badges/renfordt-colors/health.svg)](https://phpackages.com/packages/renfordt-colors) ``` ### Alternatives [hirethunk/verbs An event sourcing package that feels nice. 513162.9k6](/packages/hirethunk-verbs) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)