クラス 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 |
メソッドの詳細
IPv6アドレスを完全な表記に展開します。
例えば、2001:db8::1
は 2001: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);
}
IPバージョンを取得します。IPアドレスの検証は行いません。
public static integer getIpVersion ( $ip ) | ||
$ip | string |
有効なIPv4またはIPv6アドレス。 |
戻り値 | integer |
---|
public static function getIpVersion($ip)
{
return strpos($ip, ':') === false ? self::IPV4 : self::IPV6;
}
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範囲。例: |
$range |
string |
有効なIPv4またはIPv6 CIDR範囲。例: |
戻り値 | ブール値 |
|
---|---|---|
例外発生 | 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;
}
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;
}
コメントするにはサインアップまたはログインしてください。