0 フォロワー

クラス yii\helpers\BaseIpHelper

継承yii\helpers\BaseIpHelper
サブクラスyii\helpers\IpHelper
利用可能なバージョン2.0.14
ソースコード https://github.com/yiisoft/yii2/blob/master/framework/helpers/BaseIpHelper.php

クラス BaseIpHelper は yii\helpers\IpHelper の具体的な実装を提供します。

BaseIpHelper は使用しないでください。yii\helpers\IpHelper を代わりに使用してください。

公開メソッド

継承されたメソッドを非表示

メソッド 説明 定義元
expandIPv6() IPv6アドレスを完全な表記に展開します。 yii\helpers\BaseIpHelper
getIpVersion() IPバージョンを取得します。IPアドレスの検証は行いません。 yii\helpers\BaseIpHelper
inRange() IPアドレスまたはサブネット $subnet が $subnet に含まれているかどうかを確認します。 yii\helpers\BaseIpHelper
ip2bin() IPアドレスをビット表現に変換します。 yii\helpers\BaseIpHelper

定数

継承された定数を非表示

定数 説明 定義元
IPV4 4 yii\helpers\BaseIpHelper
IPV4_ADDRESS_LENGTH 32 IPv4アドレスの長さ(ビット単位) yii\helpers\BaseIpHelper
IPV6 6 yii\helpers\BaseIpHelper
IPV6_ADDRESS_LENGTH 128 IPv6アドレスの長さ(ビット単位) yii\helpers\BaseIpHelper

メソッドの詳細

継承されたメソッドを非表示

expandIPv6() public static method

IPv6アドレスを完全な表記に展開します。

例えば、2001:db8::12001:0db8:0000:0000:0000:0000:0000:0001 に展開されます。

public static string expandIPv6 ( $ip )
$ip string

元の有効なIPv6アドレス

戻り値 string

展開されたIPv6アドレス

                public static function expandIPv6($ip)
{
    $hex = unpack('H*hex', inet_pton($ip));
    return substr(preg_replace('/([a-f0-9]{4})/i', '$1:', $hex['hex']), 0, -1);
}

            
getIpVersion() public static method

IPバージョンを取得します。IPアドレスの検証は行いません。

public static integer getIpVersion ( $ip )
$ip string

有効なIPv4またはIPv6アドレス。

戻り値 integer

IPV4 または IPV6

                public static function getIpVersion($ip)
{
    return strpos($ip, ':') === false ? self::IPV4 : self::IPV6;
}

            
inRange() public static method

IPアドレスまたはサブネット $subnet が $subnet に含まれているかどうかを確認します。

例えば、次のコードはサブネット192.168.1.0/24がサブネット192.168.0.0/22に含まれるかどうかを確認します。

IpHelper::inRange('192.168.1.0/24', '192.168.0.0/22'); // true

単一のIPアドレス192.168.1.21がサブネット192.168.1.0/24に含まれるかどうかを確認する必要がある場合は、これらの例のいずれかを使用できます。

IpHelper::inRange('192.168.1.21', '192.168.1.0/24'); // true
IpHelper::inRange('192.168.1.21/32', '192.168.1.0/24'); // true

こちらも参照してください https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing

public static boolean inRange ( $subnet, $range )
$subnet string

有効なIPv4またはIPv6アドレス、もしくはCIDR範囲。例:10.0.0.0/8または2001:af::/64

$range string

有効なIPv4またはIPv6 CIDR範囲。例:10.0.0.0/8または2001:af::/64

戻り値 ブール値

$subnet$rangeに含まれるかどうか

例外発生 yii\base\NotSupportedException

                public static function inRange($subnet, $range)
{
    list($ip, $mask) = array_pad(explode('/', $subnet), 2, null);
    list($net, $netMask) = array_pad(explode('/', $range), 2, null);
    $ipVersion = static::getIpVersion($ip);
    $netVersion = static::getIpVersion($net);
    if ($ipVersion !== $netVersion) {
        return false;
    }
    $maxMask = $ipVersion === self::IPV4 ? self::IPV4_ADDRESS_LENGTH : self::IPV6_ADDRESS_LENGTH;
    $mask = isset($mask) ? $mask : $maxMask;
    $netMask = isset($netMask) ? $netMask : $maxMask;
    $binIp = static::ip2bin($ip);
    $binNet = static::ip2bin($net);
    return substr($binIp, 0, $netMask) === substr($binNet, 0, $netMask) && $mask >= $netMask;
}

            
ip2bin() public static メソッド

IPアドレスをビット表現に変換します。

public static string ip2bin ( $ip )
$ip string

有効なIPv4またはIPv6アドレス

戻り値 string

ビット文字列

例外発生 yii\base\NotSupportedException

                public static function ip2bin($ip)
{
    $ipBinary = null;
    if (static::getIpVersion($ip) === self::IPV4) {
        $ipBinary = pack('N', ip2long($ip));
    } elseif (@inet_pton('::1') === false) {
        throw new NotSupportedException('IPv6 is not supported by inet_pton()!');
    } else {
        $ipBinary = inet_pton($ip);
    }
    $result = '';
    for ($i = 0, $iMax = strlen($ipBinary); $i < $iMax; $i += 4) {
        $result .= str_pad(decbin(unpack('N', substr($ipBinary, $i, 4))[1]), 32, '0', STR_PAD_LEFT);
    }
    return $result;
}