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

Copy
1<?php
2
3/**
4 * ip2long 関数の基本的な使い方と、IPv6アドレスへの対応についてデモンストレーションします。
5 * ip2long 関数は IPv4 アドレスを32ビットの符号なし整数に変換します。
6 * 無効なIPアドレスやIPv6アドレスを渡すと false を返します。
7 */
8function demonstrateIp2longUsage(): void
9{
10    echo "--- ip2long 関数デモンストレーション ---" . PHP_EOL;
11
12    // 1. 有効な IPv4 アドレスの変換例
13    $ipv4Address = '192.168.1.100';
14    echo "\n[テストケース 1] 有効な IPv4 アドレス: " . $ipv4Address . PHP_EOL;
15
16    $longValue = ip2long($ipv4Address);
17
18    if ($longValue !== false) {
19        echo "  - 整数値に変換されました: " . $longValue . PHP_EOL;
20        // long2ip 関数で、変換された整数値を元のIPv4アドレスに戻すことができます
21        echo "  - long2ip で元に戻すと: " . long2ip($longValue) . PHP_EOL;
22    } else {
23        echo "  - エラー: IPv4アドレスの変換に失敗しました。" . PHP_EOL;
24    }
25
26    // 2. 無効な IPv4 アドレス（フォーマットが不正）の変換例
27    $invalidIpv4 = '256.0.0.1'; // 各オクテットは0から255の範囲である必要があります
28    echo "\n[テストケース 2] 無効な IPv4 アドレス: " . $invalidIpv4 . PHP_EOL;
29
30    $longValue = ip2long($invalidIpv4);
31
32    if ($longValue !== false) {
33        echo "  - 整数値に変換されました: " . $longValue . PHP_EOL;
34    } else {
35        // ip2long は無効なアドレスに対して false を返します
36        echo "  - エラー: 無効なIPアドレスのため、変換に失敗しました (期待される動作)。" . PHP_EOL;
37    }
38
39    // 3. IPv6 アドレスの変換例
40    // キーワードに 'ipv6' があるため、ip2long が IPv6 に対応していないことを示します。
41    $ipv6Address = '2001:0db8:85a3:0000:0000:8a2e:0370:7334';
42    echo "\n[テストケース 3] IPv6 アドレス: " . $ipv6Address . PHP_EOL;
43
44    $longValue = ip2long($ipv6Address);
45
46    if ($longValue !== false) {
47        echo "  - 整数値に変換されました: " . $longValue . PHP_EOL;
48    } else {
49        // ip2long は IPv6 アドレスに対応していません。false が返されます。
50        echo "  - エラー: ip2long は IPv6 アドレスに対応していません (期待される動作)。" . PHP_EOL;
51        echo "  - 補足: IPv6アドレスを扱う場合は、PHP の filter_var() 関数など、他の関数を検討してください。" . PHP_EOL;
52    }
53
54    // 4. 全く異なる文字列の変換例
55    $randomString = 'not an ip address';
56    echo "\n[テストケース 4] 無効な文字列: " . $randomString . PHP_EOL;
57
58    $longValue = ip2long($randomString);
59
60    if ($longValue !== false) {
61        echo "  - 整数値に変換されました: " . $longValue . PHP_EOL;
62    } else {
63        echo "  - エラー: 無効な文字列のため、変換に失敗しました (期待される動作)。" . PHP_EOL;
64    }
65
66    echo "\n--- デモンストレーション終了 ---" . PHP_EOL;
67}
68
69// 関数を実行してデモンストレーションを開始します
70demonstrateIp2longUsage();

PHPのip2long関数は、IPv4アドレスの文字列を32ビットの符号なし整数値に変換します。引数にはstring $ipとしてIPv4アドレスの文字列を指定します。変換に成功するとint型の整数値を返しますが、無効なIPv4アドレスやIPアドレス以外の文字列が渡された場合はfalseを返します。変換された整数値は、long2ip関数で元のIPv4アドレスに戻すことも可能です。

この関数はIPv6アドレスには対応していません。例えば、'192.168.1.100'のような有効なIPv4アドレスは整数に変換されますが、'256.0.0.1'のような無効なIPv4アドレスや、'2001:0db8:...'といったIPv6アドレス、または'not an ip address'のようなIPアドレス形式ではない文字列を渡すと、ip2longは常にfalseを返します。IPv6アドレスを扱う際には、filter_var()関数など、他のPHP関数を利用してください。これにより、IPアドレスの形式に応じた適切な処理を実現できます。

Copy
1<?php
2
3/**
4 * ip2long関数の使い方をデモンストレーションする関数。
5 * IPアドレス文字列を符号なしlong整数に変換し、結果を表示します。
6 * ウェブアプリケーションでユーザー入力（例: $_POST['ip_address']）を処理する際の参考にしてください。
7 *
8 * @param string $ipAddress 処理するIPアドレス文字列。
9 * @return void
10 */
11function demonstrateIp2Long(string $ipAddress): void
12{
13    echo "変換対象のIPアドレス: " . $ipAddress . PHP_EOL;
14
15    // ip2long関数を呼び出し、IPアドレスをlong整数に変換します。
16    // 有効なIPv4アドレスであれば整数値を返し、そうでなければ false を返します。
17    $longIp = ip2long($ipAddress);
18
19    if ($longIp === false) {
20        // 変換が失敗した場合の処理（無効なIPアドレス形式）
21        echo "  → エラー: IPアドレス '" . $ipAddress . "' は無効な形式です。" . PHP_EOL;
22    } else {
23        // 変換が成功した場合の処理
24        echo "  → 変換されたlong整数値: " . $longIp . PHP_EOL;
25        // long2ip関数を使うと、この整数値を元のIPアドレス文字列に戻すことも可能です。
26        // echo "  → long整数値から元のIPアドレスへ: " . long2ip($longIp) . PHP_EOL;
27    }
28    echo PHP_EOL; // 各デモンストレーションの後で見やすくするための改行
29}
30
31// --- 実際の使用例 ---
32
33// 1. 有効なIPv4アドレスの例
34demonstrateIp2Long("192.168.1.1");
35demonstrateIp2Long("10.0.0.255");
36demonstrateIp2Long("172.16.0.10");
37
38// 2. 無効なIPv4アドレスの例
39demonstrateIp2Long("256.0.0.1");     // IPアドレスのオクテットが範囲外 (0-255)
40demonstrateIp2Long("invalid-ip");   // 数字以外の文字が含まれる不正な形式
41demonstrateIp2Long("192.168.1");    // 不完全な形式（オクテットが足りない）
42demonstrateIp2Long("::1");          // IPv6アドレス (ip2longはIPv4アドレスのみ対応)
43
44?>

PHP 8で利用できるip2long関数は、指定されたIPv4アドレスの文字列を、対応する符号なしの32ビット整数値に変換するために使用されます。この関数は、IPアドレスをデータベースに数値として保存したり、IPアドレスの比較を高速に行ったりする際に便利です。

引数には、変換したいIPv4アドレスの文字列を渡します。例えば、「192.168.1.1」のような形式です。戻り値は、有効なIPv4アドレスであればそのアドレスに対応する整数値（int）として返されます。しかし、指定された文字列がIPv4アドレスとして無効な形式の場合や、IPv6アドレスが指定された場合は変換に失敗し、falseが返されます。

サンプルコードでは、demonstrateIp2Long関数を通じてip2longの挙動が示されています。有効な「192.168.1.1」や「10.0.0.255」は適切な整数値に変換されますが、「256.0.0.1」のようにオクテットが範囲外のアドレスや、「invalid-ip」のような不正な形式、さらにIPv6アドレスの「::1」はfalseを返します。このように、関数がfalseを返した際に適切にエラー処理を行うことが、堅牢なプログラムを作成する上で重要です。この関数は、ネットワーク関連の処理でIPアドレスを数値として扱う際に役立ちます。