【PHP8.x】inet_ntop()関数の使い方

inet_ntop関数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年09月29日

基本的な使い方

inet_ntop関数は、ネットワークアドレスを人間が読める形式に変換する関数です。この関数は、バイナリ形式で表されたIPアドレス（IPv4またはIPv6）を、私たちが普段目にする「192.168.1.1」や「2001:0db8::1」のようなドット区切りやコロン区切りの文字列形式に変換するために使用されます。例えば、データベースやネットワーク通信から取得したIPアドレスがバイナリデータとして渡された際に、それを画面に表示したり、ログファイルに記録したりする目的で利用されます。

引数には、変換したいバイナリ形式のIPアドレスを指定します。PHPの内部では、このバイナリデータがIPv4アドレスかIPv6アドレスかを自動的に判別し、適切な形式の文字列へと変換します。変換に成功した場合、この関数はIPアドレスの文字列を返します。もし、入力されたバイナリデータが不正な形式であったり、有効なIPアドレスとして解釈できなかったりした場合には、falseを返しますので、関数の戻り値を確認してエラー処理を行うことが重要です。この関数は、ネットワーク関連のプログラミングにおいて、IPアドレスの表現形式を変換する際に役立ちます。

構文(syntax)


1<?php
2// IPアドレスのバイナリ表現を人間が読める形式に変換します。
3// 例: '127.0.0.1' をバイナリ形式に変換し、さらに人間が読める形式に戻す
4$packedIpAddress = inet_pton('127.0.0.1'); // '127.0.0.1' のバイナリ形式を取得
5$readableIpAddress = inet_ntop($packedIpAddress); // バイナリ形式を人間が読める形式に変換
6?>

引数(parameters)

string $ip

string $ip: 変換するIPアドレス（IPv4またはIPv6）を指定する文字列

戻り値(return)

string|false

バイナリ形式のIPv4またはIPv6アドレスを、人間が読みやすいドット区切りまたはコロン区切り表記の文字列に変換します。変換に失敗した場合はfalseを返します。

サンプルコード

PHPでIPアドレスを相互変換する


1<?php
2
3/**
4 * このスクリプトは、IPアドレスのテキスト形式とバイナリ形式の相互変換を示す例です。
5 *
6 * inet_pton() はテキスト形式のIPアドレス (例: "192.168.1.1", "::1") を
7 * バイナリ形式のIPアドレス (ネットワークバイトオーダーの短い文字列) に変換します。
8 *
9 * inet_ntop() はバイナリ形式のIPアドレスを
10 * テキスト形式のIPアドレスに変換します。
11 *
12 * これらの関数は、ネットワークプログラミングでIPアドレスをデータベースに格納したり、
13 * ネットワークパケットを処理する際に使用されます。
14 */
15
16// --- IPv4アドレスの変換例 ---
17
18$ipv4AddressText = '192.168.1.100';
19echo "--- IPv4 アドレスの変換例 ---\n";
20echo "元のIPv4アドレス (テキスト形式): " . $ipv4AddressText . "\n";
21
22// 1. テキスト形式のIPv4アドレスをバイナリ形式に変換
23// inet_pton() は成功するとバイナリ文字列を、失敗すると false を返します。
24$ipv4AddressBinary = inet_pton($ipv4AddressText);
25
26if ($ipv4AddressBinary === false) {
27    echo "エラー: IPv4アドレス '" . $ipv4AddressText . "' をバイナリ形式に変換できませんでした。\n";
28} else {
29    // バイナリ形式は直接表示しても読めないので、bin2hex() で16進数文字列に変換して表示
30    echo "変換後のIPv4アドレス (バイナリ形式 - 16進数): " . bin2hex($ipv4AddressBinary) . "\n";
31
32    // 2. バイナリ形式のIPv4アドレスをテキスト形式に戻す
33    // inet_ntop() は成功するとテキスト文字列を、失敗すると false を返します。
34    $ipv4AddressTextConverted = inet_ntop($ipv4AddressBinary);
35
36    if ($ipv4AddressTextConverted === false) {
37        echo "エラー: バイナリ形式のIPv4アドレスをテキスト形式に変換できませんでした。\n";
38    } else {
39        echo "再度変換後のIPv4アドレス (テキスト形式): " . $ipv4AddressTextConverted . "\n";
40        
41        // 元のIPアドレスと一致するか確認
42        if ($ipv4AddressText === $ipv4AddressTextConverted) {
43            echo "IPv4アドレスの相互変換が成功しました。\n";
44        } else {
45            echo "IPv4アドレスの相互変換が失敗しました。\n";
46        }
47    }
48}
49
50echo "\n"; // 区切り線
51
52// --- IPv6アドレスの変換例 ---
53
54$ipv6AddressText = '2001:0db8:85a3:0000:0000:8a2e:0370:7334';
55echo "--- IPv6 アドレスの変換例 ---\n";
56echo "元のIPv6アドレス (テキスト形式): " . $ipv6AddressText . "\n";
57
58// 1. テキスト形式のIPv6アドレスをバイナリ形式に変換
59$ipv6AddressBinary = inet_pton($ipv6AddressText);
60
61if ($ipv6AddressBinary === false) {
62    echo "エラー: IPv6アドレス '" . $ipv6AddressText . "' をバイナリ形式に変換できませんでした。\n";
63} else {
64    // バイナリ形式は直接表示しても読めないので、bin2hex() で16進数文字列に変換して表示
65    echo "変換後のIPv6アドレス (バイナリ形式 - 16進数): " . bin2hex($ipv6AddressBinary) . "\n";
66
67    // 2. バイナリ形式のIPv6アドレスをテキスト形式に戻す
68    $ipv6AddressTextConverted = inet_ntop($ipv6AddressBinary);
69
70    if ($ipv6AddressTextConverted === false) {
71        echo "エラー: バイナリ形式のIPv6アドレスをテキスト形式に変換できませんでした。\n";
72    } else {
73        // inet_ntop() はIPv6アドレスを正規化された短い形式に変換することがあります。
74        // 例: '2001:0db8:85a3:0000:0000:8a2e:0370:7334' -> '2001:db8:85a3::8a2e:370:7334'
75        echo "再度変換後のIPv6アドレス (テキスト形式): " . $ipv6AddressTextConverted . "\n";
76        echo "IPv6アドレスの相互変換が成功しました (正規化された形式)。\n";
77    }
78}
79
80?>

このPHPサンプルコードは、IPアドレスのテキスト形式とバイナリ形式を相互に変換するinet_pton関数とinet_ntop関数の使い方を示しています。

inet_pton関数は、"192.168.1.1"や"::1"のような人間が読みやすいテキスト形式のIPアドレス（string型）を引数として受け取り、コンピュータが効率的に扱える短いバイナリ形式（string型）に変換します。変換に成功するとバイナリ文字列を、失敗した場合はfalseを返します。

逆にinet_ntop関数は、inet_ptonで変換されたバイナリ形式のIPアドレス（string型）を引数とし、再び元のテキスト形式のIPアドレス（string型）に戻す役割を持っています。こちらも成功するとテキスト文字列を、失敗するとfalseを返します。

これらの関数は、データベースにIPアドレスを効率よく格納したい場合や、ネットワークパケットのIPアドレス情報を処理する必要がある場合に活用されます。サンプルコードでは、IPv4とIPv6の両方について、inet_ptonでテキスト形式からバイナリ形式へ変換し、その後inet_ntopでバイナリ形式からテキスト形式へ戻す流れを解説しています。バイナリ形式は直接読めないため、bin2hex関数を使って16進数で表示し、内容を確認できるようにしています。特にIPv6アドレスの変換では、inet_ntopが正規化された短い形式を返す場合があることも確認できます。

inet_pton関数とinet_ntop関数は、テキスト形式のIPアドレスとバイナリ形式のIPアドレスを相互に変換します。これらの関数は、IPアドレスをデータベースに効率的に保存したり、ネットワークプログラミングで扱う際に非常に役立ちます。

利用上の重要な注意点として、どちらの関数も変換に失敗した場合にfalseを返します。そのため、必ず戻り値がfalseでないかを確認し、適切なエラー処理を行うようにしてください。バイナリ形式のIPアドレスは人間が直接読める形式ではないため、デバッグ目的で表示する際はbin2hex()関数を使って16進数文字列に変換すると良いでしょう。また、inet_ntop関数はIPv6アドレスを短縮形に正規化して返すことがありますので、元の文字列と厳密に一致するかどうかを比較する際には注意が必要です。

inet_ntop を使ったIPアドレス変換


1<?php
2
3/**
4 * IPアドレスのバイナリ形式を人間が読める形式に変換する inet_ntop 関数の使用例を示します。
5 * IPv4およびIPv6アドレスの変換と、無効な入力に対するエラーハンドリングを含みます。
6 *
7 * @return void
8 */
9function demonstrateInetNtopUsage(): void
10{
11    echo "--- IPv4 アドレスの変換 ---" . PHP_EOL;
12
13    // IPv4アドレス "192.168.1.100" をバイナリ形式に変換します。
14    // inet_pton は inet_ntop の逆関数で、人間が読めるIPアドレスをバイナリ形式に変換します。
15    $ipv4String = "192.168.1.100";
16    $ipv4Binary = inet_pton($ipv4String);
17
18    if ($ipv4Binary === false) {
19        echo "エラー: '{$ipv4String}' をバイナリ形式に変換できませんでした。" . PHP_EOL;
20    } else {
21        echo "元のIPv4アドレス: {$ipv4String}" . PHP_EOL;
22        // デバッグ目的でバイナリデータを16進数で表示します。
23        echo "バイナリ形式 (16進数): " . bin2hex($ipv4Binary) . PHP_EOL;
24        
25        // inet_ntop を使ってバイナリ形式を人間が読めるドット形式に変換します。
26        $convertedIpv4 = inet_ntop($ipv4Binary);
27        
28        if ($convertedIpv4 === false) {
29            echo "エラー: バイナリ形式をIPv4アドレスに変換できませんでした。" . PHP_EOL;
30        } else {
31            echo "inet_ntop で変換されたIPv4アドレス: {$convertedIpv4}" . PHP_EOL;
32        }
33    }
34
35    echo PHP_EOL . "--- IPv6 アドレスの変換 ---" . PHP_EOL;
36
37    // IPv6アドレス "2001:db8::1" をバイナリ形式に変換します。
38    // 短縮形も inet_pton は正しく処理できます。
39    $ipv6String = "2001:db8::1"; 
40    $ipv6Binary = inet_pton($ipv6String);
41
42    if ($ipv6Binary === false) {
43        echo "エラー: '{$ipv6String}' をバイナリ形式に変換できませんでした。" . PHP_EOL;
44    } else {
45        echo "元のIPv6アドレス: {$ipv6String}" . PHP_EOL;
46        // デバッグ目的でバイナリデータを16進数で表示します。
47        echo "バイナリ形式 (16進数): " . bin2hex($ipv6Binary) . PHP_EOL;
48
49        // inet_ntop を使ってバイナリ形式を人間が読めるコロン形式に変換します。
50        $convertedIpv6 = inet_ntop($ipv6Binary);
51
52        if ($convertedIpv6 === false) {
53            echo "エラー: バイナリ形式をIPv6アドレスに変換できませんでした。" . PHP_EOL;
54        } else {
55            echo "inet_ntop で変換されたIPv6アドレス: {$convertedIpv6}" . PHP_EOL;
56        }
57    }
58
59    echo PHP_EOL . "--- 無効な入力の処理 ---" . PHP_EOL;
60
61    // inet_ntop は、IPアドレスとして無効なバイナリデータが与えられた場合、false を返します。
62    $invalidBinary = "これはIPアドレスではありません"; 
63    echo "無効なバイナリデータ: \"{$invalidBinary}\"" . PHP_EOL;
64
65    $resultInvalid = inet_ntop($invalidBinary);
66    if ($resultInvalid === false) {
67        echo "inet_ntop は無効な入力に対して false を返しました。(期待通りの挙動)" . PHP_EOL;
68    } else {
69        echo "エラー: inet_ntop が無効な入力に対して予期せぬ結果を返しました: {$resultInvalid}" . PHP_EOL;
70    }
71}
72
73// 関数を実行して、inet_ntop の動作を確認します。
74demonstrateInetNtopUsage();
75

PHPのinet_ntop関数は、コンピュータが内部で扱うバイナリ形式のIPアドレスを、人間が読みやすい文字列形式（IPv4ならドット区切り、IPv6ならコロン区切り）に変換するために使用されます。この関数は、主にネットワーク通信やログ記録の際に、IPアドレスを分かりやすく表示したい場合に役立ちます。

引数には変換したいバイナリ形式のIPアドレス文字列を渡します。成功した場合は、対応するIPアドレスの文字列が返されます。例えば、IPアドレス文字列をバイナリ形式に変換するinet_pton関数で得られたデータ（"192.168.1.100"や"2001:db8::1"など）をinet_ntopに渡すと、それぞれの元の文字列形式が戻ります。

もし引数として渡されたデータが有効なIPアドレスのバイナリ形式でない場合や、変換に失敗した場合はfalseを返します。そのため、戻り値がfalseでないかを確認することで、エラーハンドリングを行うことができます。このように、inet_ntopはIPアドレスの形式変換を安全かつ正確に行うための重要な関数です。

inet_ntop関数は、IPアドレスのバイナリ形式を人間が読める文字列形式に変換する際に使用します。この関数に渡す引数は、必ずinet_pton関数などでバイナリ形式に変換されたIPアドレスである必要があります。直接「192.168.1.1」のような文字列形式のIPアドレスを渡すと、無効な入力として処理されfalseが返されるため注意が必要です。

処理に失敗した場合、この関数はfalseを返しますので、戻り値は必ず=== falseと厳密に比較してエラーハンドリングを行うことが重要です。IPv4およびIPv6アドレスの両方に対応しており、PHPの標準機能として提供されているため、ネットワーク関連のプログラムでIPアドレスを表示したりログに出力したりする際に役立ちます。