【PHP8.x】long2ip関数の使い方

<?php

/**
 * long2ip() 関数は、整数形式のIPアドレスをドット区切り形式の文字列に変換します。
 * 主に、データベースに整数として保存されたIPアドレスを表示する際などに使用されます。
 *
 * このサンプルコードでは、まずドット区切りIPアドレスを整数に変換し、
 * その後 long2ip() を使って元のドット区切り形式に戻す方法を示します。
 */

// 例として、ドット区切り形式のIPv4アドレスを定義します。
$ipAddressString = "192.168.1.10";

// ip2long() 関数を使用して、ドット区切り形式のIPアドレスを整数形式に変換します。
// 成功すると整数、失敗すると false が返されます。
$ipAddressLong = ip2long($ipAddressString);

// 変換が成功したかを確認します。
if ($ipAddressLong === false) {
    echo "エラー: IPアドレス '{$ipAddressString}' の整数への変換に失敗しました。\n";
} else {
    echo "元のIPアドレス (文字列): " . $ipAddressString . "\n";
    echo "変換されたIPアドレス (整数): " . $ipAddressLong . "\n\n";

    // long2ip() 関数を使用して、整数形式のIPアドレスをドット区切り形式の文字列に戻します。
    // 成功するとIPアドレスの文字列、失敗すると false が返されます。
    // 通常、ip2long() で得られた有効な整数を渡す限り、変換は成功します。
    $convertedIpAddressString = long2ip($ipAddressLong);

    // 変換が成功したかを確認します。
    if ($convertedIpAddressString === false) {
        echo "エラー: 整数 '{$ipAddressLong}' からIPアドレスへの変換に失敗しました。\n";
    } else {
        echo "整数から再変換したIPアドレス (文字列): " . $convertedIpAddressString . "\n";
    }
}

// 無効な整数値を試す（例: 負の値や大きすぎる値）
// long2ip() は基本的にIPv4のアドレス範囲内の整数値を期待します。
// 範囲外の値を渡すと意図しない結果や false が返る可能性があります。
$invalidIpLong = -1; // 無効な例
$resultInvalid = long2ip($invalidIpLong);
echo "\n無効な整数値 (-1) の変換結果: ";
if ($resultInvalid === false) {
    echo "false (変換失敗)\n";
} else {
    echo $resultInvalid . "\n"; // PHP 8では "255.255.255.255" が返る
}

PHPのlong2ip関数は、整数形式で表現されたIPv4アドレスを、一般的な「192.168.1.1」のようなドット区切り形式の文字列に変換する際に使用されます。主に、IPアドレスをデータベースに整数として保存している場合に、それを人間が読める形式で表示する用途で役立ちます。

この関数は、整数値のIPアドレスを引数として一つ受け取ります。変換が成功するとドット区切り形式のIPアドレス文字列を返し、失敗した場合はfalseを返します。そのため、戻り値がfalseでないかを確認する処理は、エラー発生時の対応として重要です。

サンプルコードでは、まずip2long関数を使って文字列形式のIPアドレス「192.168.1.10」を整数値に変換しています。次に、その変換された整数値をlong2ip関数に渡し、元のドット区切り形式に戻しています。変換の成否は都度チェックしています。また、long2ip関数はIPv4アドレスの範囲内の整数値を期待するため、無効な整数値（例えば-1）を渡すと、PHP 8では「255.255.255.255」が返されるなど、意図しない結果になる可能性がある点にも注意が必要です。