PHPプログラミングにおいて、16進数はデータの符号化や色の指定、さらには低レイヤーの通信処理など、多岐にわたる場面で利用されます。

Webアプリケーションの開発では、色の16進数コード(#FFFFFFなど)を扱ったり、バイナリデータを読みやすい形式に変換したりする機会が頻繁にあります。

本記事では、PHPで16進数を効率的かつ正確に扱うための基本的な変換関数から、実践的な計算・文字列操作のテクニックまでを詳しく紹介します。

最新のPHPバージョンにおける仕様を把握し、型安全でメンテナンス性の高いコードを書くための知識を深めていきましょう。

PHPにおける16進数の基本表現

PHPでは、数値リテラルとして16進数を直接記述することが可能です。

16進数を表現する際は、数値の先頭に「0x」または「0X」を付与します。

この記述形式を用いると、PHPエンジンは自動的に整数(int型)として値を解釈します。

PHP
<?php
// 16進数リテラルを整数として定義
$hexValue = 0xFF; // 10進数の255
$largeHex = 0x1A2B3C;

echo $hexValue;
?>
実行結果
255

このように、コード内で定数として16進数を扱う場合は、クォーテーションで囲わずにそのまま記述するのが一般的です。

ただし、外部のAPIやユーザー入力から渡される16進数は「文字列」として扱われることが多いため、適切な変換処理が必要になります。

10進数と16進数の相互変換

PHPには、10進数と16進数を相互に変換するための標準関数が用意されています。

これらの関数を使い分けることで、数値計算と表示用文字列の操作をスムーズに行えます。

dechex関数:10進数から16進数への変換

dechex()関数は、引数に渡された10進数の整数を、小文字の16進数文字列に変換します。

PHP
<?php
$decimal = 255;
$hexString = dechex($decimal);

echo $hexString;
?>
実行結果
ff

この関数は非常にシンプルですが、返り値は常に文字列型(string)になる点に注意してください。

また、負の数を渡した場合は、プラットフォーム(32bit/64bit)に依存した符号なし整数の表現が返されます。

hexdec関数:16進数文字列から10進数への変換

逆に、16進数の文字列を10進数の整数に変換するには、hexdec()関数を使用します。

文字列の先頭に「0x」が付いていても、付いていなくても正しく処理されます。

PHP
<?php
$hexStr1 = "ff";
$hexStr2 = "0x1A2B";

echo hexdec($hexStr1) . PHP_EOL;
echo hexdec($hexStr2);
?>
実行結果
255
6699

hexdec()は非常に柔軟で、渡された文字列に含まれる無効な文字を無視して変換を試みます。

しかし、PHP 8.0以降では、非数値が含まれる場合の挙動がより厳格になっているため、入力値のバリデーションを事前に行うことが推奨されます。

バイナリデータと16進数の変換

ファイル操作や暗号化処理、ネットワーク通信では、バイナリデータ(rawデータ)を16進数表現で確認したい場合があります。

その際に利用されるのが、bin2hex()hex2bin()です。

bin2hex関数によるデータの可視化

bin2hex()関数は、バイナリ形式の文字列を16進数の値に変換します。

これは、画像データのヘッダ確認や、ハッシュ値の表示などでよく使われます。

PHP
<?php
$binaryData = "Hello";
$hexRepresentation = bin2hex($binaryData);

echo $hexRepresentation;
?>
実行結果
48656c6c6f

「H」は16進数で「48」、「e」は「65」といった具合に、各文字のバイト値が並んで出力されます。

hex2bin関数によるバイナリへの復元

hex2bin()関数は、16進数で表現された文字列を元のバイナリ形式に変換します。

この関数を使用する際は、16進数の文字列が偶数長である必要がある点に注意が必要です。

PHP
<?php
$hexString = "48656c6c6f";
$binaryData = hex2bin($hexString);

echo $binaryData;
?>
実行結果
Hello

もし文字列が奇数長であった場合、E_WARNINGレベルのエラーが発生し、falseが返されます。

フォーマット指定による16進数の出力

数値を16進数として表示する際、特定の桁数でゼロ埋め(パディング)をしたり、大文字で表示したりしたいことがあります。

その場合は、sprintf()またはprintf()関数を利用するのが最も効率的です。

大文字・小文字と桁の制御

sprintf()のフォーマット指定子を用いることで、柔軟な出力が可能です。

指定子説明例 (数値: 255)
%x小文字の16進数ff
%X大文字の16進数FF
%02x2桁になるよう小文字でゼロ埋めff
%06X6桁になるよう大文字でゼロ埋め0000FF

カラーコードのように必ず一定の桁数が必要な場面では、sprintf('%06x', $val)のような記述が多用されます。

PHP
<?php
$r = 255;
$g = 165;
$b = 0;

// オレンジ色のカラーコードを生成
$hexColor = sprintf("#%02X%02X%02X", $r, $g, $b);

echo $hexColor;
?>
実行結果
#FFA500

16進数を用いた計算の実践

PHPでは、16進数リテラル同士の計算をそのまま行うことができます。

内部的には整数として処理されるため、加減乗除といった算術演算子がそのまま適用可能です。

PHP
<?php
$baseValue = 0x10; // 16
$addValue = 0x05;  // 5

$result = $baseValue + $addValue;

echo "結果 (10進数): " . $result . PHP_EOL;
echo "結果 (16進数): 0x" . dechex($result);
?>
実行結果
結果 (10進数): 21
結果 (16進数): 0x15

ビット演算(AND, OR, XOR, NOT)を行う際も、16進数表記を用いるとフラグの状態を直感的に把握しやすくなります。

例えば、特定のフラグが立っているかを確認する処理では、0x010x020x04といった16進数値が頻繁に登場します。

文字列操作と16進数エスケープ

PHPのダブルクォートで囲まれた文字列内では、\xに続く2桁の16進数を使用して、特定の文字をエスケープシーケンスとして記述できます。

これは、制御文字や特殊な文字コードを文字列に含めたい場合に便利です。

PHP
<?php
// 改行コード (LF) を16進数エスケープで記述
$string = "Line 1\x0ALine 2";

echo $string;
?>

マルチバイト文字列(UTF-8など)を扱う場合、16進数エスケープはバイト単位で解釈されるため、日本語などの多バイト文字を扱う際は注意が必要です。

UTF-8の文字を16進数で指定する場合は、その文字の全バイトを正しく記述しなければなりません。

実用例:16進数カラーコードのパースと変換

Web制作でよくある、16進数カラーコード(#RRGGBB)をRGBの配列に変換するロジックを実装してみましょう。

ここでは、文字列の切り出し(substr)と、先述のhexdecを組み合わせて使用します。

PHP
<?php
function hexToRgb($hex) {
    // 先頭の#を取り除く
    $hex = ltrim($hex, '#');
    
    // 3桁表記(#FFFなど)を6桁に変換
    if (strlen($hex) === 3) {
        $hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
    }
    
    return [
        'r' => hexdec(substr($hex, 0, 2)),
        'g' => hexdec(substr($hex, 2, 2)),
        'b' => hexdec(substr($hex, 4, 2)),
    ];
}

$rgb = hexToRgb("#3498db");
print_r($rgb);
?>
実行結果
Array
(
    [r] => 52
    [g] => 152
    [b] => 219
)

このように、基本的な関数を組み合わせるだけで、実用性の高いツールを作成することができます。

入力される文字列の形式が多様な場合は、正規表現(preg_match)を用いて事前にフォーマットをチェックすると、より堅牢なプログラムになります。

まとめ

PHPで16進数を扱うための主要な手法について、基本的なリテラル表記から関数による変換、フォーマット出力まで幅広く解説しました。

dechexhexdecは数値としての変換に、bin2hexhex2binはデータ形式の変換に適しています。

また、表示形式を整える際にはsprintfを活用することで、可読性の高いコードを実現できるでしょう。

16進数の扱いをマスターすることは、データの内部構造を理解し、より高度なプログラムを構築するための第一歩です。

本記事で紹介したテクニックを、日々の開発業務やシステムの最適化にぜひ役立ててください。