トップページ　→関数リファレンス　→その他のサービス　→ネットワーク　→ネットワーク関数

関数・クラス解説

ip2long

version:PHP 4, PHP 5, PHP 7 (公式)

ドット表記の (IPv4) IP アドレスを、長整数表現に変換する

公式リファレンス

書式

ip2long ( string $ip_address ) : int

説明

関数 ip2long() は、インターネット標準形式 (ドット表記の文字列) 表現から、長整数表現の IPv4 インターネットネットアドレスを生成します。

ip2long() は不完全な形式の IP アドレスに対しても動作します。詳しい情報は » http://publibn.boulder.ibm.com/doc_link/en_US/a_doc_lib/libs/commtrf2/inet_addr.htm を参照ください。

パラメータ

ip_address: 標準形式のアドレス。

返値

長整数値、あるいは ip_address が不正な形式の場合に FALSE を返します。

注意

注意: PHP の整数型は符号付き形式であり、32 ビットアーキテクチャ上では多くの IP アドレスが負の整数値になります。そのため、符号なし IP アドレスを文字列形式で取得するには sprintf() や printf() で "%u" を使用する必要があります。

注意: PHP 5 <= 5.0.2 での IP 255.255.255.255、 PHP 5 <= 5.2.4 での 64 ビット・システムでの -1 に対して ip2long() が FALSE を返します。これは PHP 5.2.5 で 4294967295 を返すように修正されています。 32 ビット・システムでは、整数オーバーフローにより -1 を返します。

サンプル

例1 ip2long() の例 

$ip = gethostbyname('www.example.com');
$out = "以下の URL は同じ意味です:\n";
$out .= 'http://www.example.com/, http://' . $ip . '/, そして http://' . sprintf("%u", ip2long($ip)) . "/\n";
echo $out;

 例2 IP アドレスの表示
  2 番目の例は、変換されたアドレスを printf() 関数で出力する方法を示すものです。  

$ip   = gethostbyname('www.example.com');
$long = ip2long($ip);

if ($long == -1 || $long === FALSE) {
    echo '無効な IP です。もういちど確認してください。';
} else {
    echo $ip   . "\n";            // 192.0.34.166
    echo $long . "\n";            // 3221234342 (32 ビット・システムでの -1073732954。整数オーバーフローによるものです)
    printf("%u\n", ip2long($ip)); // 3221234342
}