16進数カラーコードをHSLに変換するPHP関数の実装と使い方

Web制作やプログラミングでは、16進数(Hex)形式のカラーコードをHSL(色相・彩度・輝度)形式に変換したい場面が少なくありません。特に、色の明るさや鮮やかさをプログラムで動的に調整したい場合、HSL形式の方が直感的に扱えます。

以下のPHP関数を使えば、16進数のカラーコードをHSL値に簡単に変換できます。

16進数をHSLに変換するPHP関数のコード

function hexToHsl($hex) {
    // 先頭の「#」を除去
    $hex = ltrim($hex, '#');

    // 16進数を R・G・B の2桁ずつに分解
    $hex_val = array($hex[0].$hex[1], $hex[2].$hex[3], $hex[4].$hex[5]);

    // 各成分を 0〜1 の範囲に正規化
    $rgb_val = array_map(function($part) {
        return hexdec($part) / 255;
    }, $hex_val);

    $max_val = max($rgb_val);
    $min_val = min($rgb_val);

    // 輝度(L)を計算
    $l = ($max_val + $min_val) / 2;

    if ($max_val == $min_val) {
        // グレー(無彩色)の場合は色相・彩度ともに 0
        $h = $s = 0;
    } else {
        $diff = $max_val - $min_val;

        // 彩度(S)を計算
        $s = $l > 0.5 ? $diff / (2 - $max_val - $min_val) : $diff / ($max_val + $min_val);

        // 色相(H)を計算
        switch($max_val) {
            case $rgb_val[0]:
                $h = ($rgb_val[1] - $rgb_val[2]) / $diff + ($rgb_val[1] < $rgb_val[2] ? 6 : 0);
                break;
            case $rgb_val[1]:
                $h = ($rgb_val[2] - $rgb_val[0]) / $diff + 2;
                break;
            case $rgb_val[2]:
                $h = ($rgb_val[0] - $rgb_val[1]) / $diff + 4;
                break;
        }
        $h /= 6;
    }

    return array($h, $s, $l);
}

関数の使い方

戻り値は array($h, $s, $l) の形式で、それぞれ 0〜1 の範囲の値が格納されています。CSSなどで実際に使用する場合は、以下のように変換すると便利です。

$hsl = hexToHsl('#FF5733');

echo 'hsl(' . round($hsl[0] * 360) . ', '
           . round($hsl[1] * 100) . '%, '
           . round($hsl[2] * 100) . '%)';
// 出力例: hsl(11, 100%, 60%)

処理の流れを解説

1. 16進数の分解: 「#FF5733」のようなカラーコードを、R・G・Bそれぞれ2桁ずつに分割します。
2. RGB値への変換: hexdec() で16進数を10進数に変換し、255で割ることで 0〜1 の範囲に正規化します。
3. 輝度(L)の計算: RGBの最大値と最小値の平均を求めます。
4. 彩度(S)の計算: 輝度が 0.5 より大きいかどうかで計算式を切り替えます。
5. 色相(H)の計算: RGBのどの成分が最大かによって式を使い分け、最後に6で割って 0〜1 の範囲に収めます。

この関数を活用すれば、カラーパレットの自動生成やテーマカラーの明暗バリエーション作成など、色を扱うさまざまな処理に応用できます。ぜひプロジェクトに組み込んでみてください。