1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
namespace Yiisoft\NetworkUtilities\Tests; |
4
|
|
|
|
5
|
|
|
|
6
|
|
|
use InvalidArgumentException; |
7
|
|
|
use Yiisoft\NetworkUtilities\IpHelper; |
8
|
|
|
use PHPUnit\Framework\TestCase; |
9
|
|
|
|
10
|
|
|
class IpHelperTest extends TestCase |
11
|
|
|
{ |
12
|
|
|
/** |
13
|
|
|
* @dataProvider getIpVersionProvider |
14
|
|
|
*/ |
15
|
|
|
public function testGetIpVersion(string $value, bool $validation, ?int $expectedVersion, ?string $expectedException = null, string $message = ''): void |
16
|
|
|
{ |
17
|
|
|
if ($expectedException !== null) { |
18
|
|
|
$this->expectException($expectedException); |
19
|
|
|
} |
20
|
|
|
$version = IpHelper::getIpVersion($value, $validation); |
21
|
|
|
if ($expectedException === null) { |
22
|
|
|
$this->assertSame($expectedVersion, $version, $message); |
23
|
|
|
} |
24
|
|
|
} |
25
|
|
|
|
26
|
|
|
public function getIpVersionProvider(): array |
27
|
|
|
{ |
28
|
|
|
return [ |
29
|
|
|
'emptyString' => ['', false, null, \InvalidArgumentException::class], |
30
|
|
|
'emptyStringValidate' => ['', true, null, \InvalidArgumentException::class], |
31
|
|
|
'tooShort' => ['1', false, null, \InvalidArgumentException::class], |
32
|
|
|
'tooShortValidate' => ['1', true, null, \InvalidArgumentException::class], |
33
|
|
|
'ipv4Minimal' => ['0.0.0.0', false, IpHelper::IPV4], |
34
|
|
|
'ipv4TooShort' => ['0.0.0.', false, null, \InvalidArgumentException::class], |
35
|
|
|
'ipv4' => ['192.168.0.1', false, IpHelper::IPV4], |
36
|
|
|
'ipv4Max' => ['255.255.255.255', false, IpHelper::IPV4], |
37
|
|
|
'ipv4MaxValidation' => ['255.255.255.255', true, IpHelper::IPV4], |
38
|
|
|
'ipv4OverMax' => ['255.255.255.256', true, null, \InvalidArgumentException::class], |
39
|
|
|
'ipv4Cidr' => ['192.168.0.1/24', false, IpHelper::IPV4, null, 'IPv4 with CIDR is resolved correctly'], |
40
|
|
|
'ipv4CidrValidation' => ['192.168.0.1/24', true, null, \InvalidArgumentException::class], |
41
|
|
|
'ipv6' => ['fb01::1', false, IpHelper::IPV6], |
42
|
|
|
'ipv6Cidr' => ['fb01::1/24', false, IpHelper::IPV6, null, 'IPv6 with CIDR is resolved correctly'], |
43
|
|
|
'ipv6CidrValidation' => ['fb01::1/24', true, null, \InvalidArgumentException::class], |
44
|
|
|
'ipv6Minimal' => ['::', false, IpHelper::IPV6], |
45
|
|
|
'ipv6MinimalValidation' => ['::', true, IpHelper::IPV6], |
46
|
|
|
'ipv6MappedIpv4' => ['::ffff:192.168.0.2', false, IpHelper::IPV6], |
47
|
|
|
'ipv6MappedIpv4Validation' => ['::ffff:192.168.0.2', true, IpHelper::IPV6], |
48
|
|
|
'ipv6Full' => ['fa01:0000:0000:0000:0000:0000:0000:0001', false, IpHelper::IPV6], |
49
|
|
|
'ipv6FullValidation' => ['fa01:0000:0000:0000:0000:0000:0000:0001', true, IpHelper::IPV6], |
50
|
|
|
]; |
51
|
|
|
} |
52
|
|
|
|
53
|
|
|
/** |
54
|
|
|
* @dataProvider expandIpv6Provider |
55
|
|
|
*/ |
56
|
|
|
public function testExpandIpv6(string $value, string $expected): void |
57
|
|
|
{ |
58
|
|
|
$expanded = IpHelper::expandIPv6($value); |
59
|
|
|
$this->assertSame($expected, $expanded); |
60
|
|
|
} |
61
|
|
|
|
62
|
|
|
public function expandIpv6Provider(): array |
63
|
|
|
{ |
64
|
|
|
return [ |
65
|
|
|
['fa01::1', 'fa01:0000:0000:0000:0000:0000:0000:0001'], |
66
|
|
|
['2001:db0:1:2::7', '2001:0db0:0001:0002:0000:0000:0000:0007'], |
67
|
|
|
]; |
68
|
|
|
} |
69
|
|
|
|
70
|
|
|
public function testIpv6ExpandingWithInvalidValue(): void |
71
|
|
|
{ |
72
|
|
|
$this->expectException(\InvalidArgumentException::class); |
73
|
|
|
IpHelper::expandIPv6('fa01::1/64'); |
74
|
|
|
} |
75
|
|
|
|
76
|
|
|
/** |
77
|
|
|
* @dataProvider ip2binProvider |
78
|
|
|
*/ |
79
|
|
|
public function testIp2bin(string $value, string $expected): void |
80
|
|
|
{ |
81
|
|
|
$result = IpHelper::ip2bin($value); |
82
|
|
|
$this->assertSame($expected, $result); |
83
|
|
|
} |
84
|
|
|
|
85
|
|
|
public function ip2binProvider(): array |
86
|
|
|
{ |
87
|
|
|
return [ |
88
|
|
|
['192.168.1.1', '11000000101010000000000100000001'], |
89
|
|
|
['fa01:0000:0000:0000:0000:0000:0000:0001', '11111010000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001'], |
90
|
|
|
['fa01::1', '11111010000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001'], |
91
|
|
|
['2620:0:2d0:200::7', '00100110001000000000000000000000000000101101000000000010000000000000000000000000000000000000000000000000000000000000000000000111'], |
92
|
|
|
]; |
93
|
|
|
} |
94
|
|
|
|
95
|
|
|
/** |
96
|
|
|
* @dataProvider inRangeProvider |
97
|
|
|
*/ |
98
|
|
|
public function testInRange(string $value, string $range, bool $expected): void |
99
|
|
|
{ |
100
|
|
|
$result = IpHelper::inRange($value, $range); |
101
|
|
|
$this->assertSame($expected, $result); |
102
|
|
|
} |
103
|
|
|
|
104
|
|
|
public function inRangeProvider(): array |
105
|
|
|
{ |
106
|
|
|
return [ |
107
|
|
|
['192.168.1.1/24', '192.168.0.0/23', true], |
108
|
|
|
['192.168.1.1/24', '192.168.0.0/24', false], |
109
|
|
|
['192.168.1.1/24', '0.0.0.0/0', true], |
110
|
|
|
['192.168.1.1/32', '192.168.1.1', true], |
111
|
|
|
['192.168.1.1/32', '192.168.1.1/32', true], |
112
|
|
|
['192.168.1.1', '192.168.1.1/32', true], |
113
|
|
|
['fa01::1/128', 'fa01::/64', true], |
114
|
|
|
['fa01::1/128', 'fa01::1/128', true], |
115
|
|
|
['fa01::1/64', 'fa01::1/128', false], |
116
|
|
|
['2620:0:0:0:0:0:0:0', '2620:0:2d0:200::7/32', true], |
117
|
|
|
]; |
118
|
|
|
} |
119
|
|
|
|
120
|
|
|
public function getCidrBitsDataProvider(): array |
121
|
|
|
{ |
122
|
|
|
return [ |
123
|
|
|
'invalidEmpty' => ['', null, \InvalidArgumentException::class], |
124
|
|
|
'invalidTooShort' => ['1', null, \InvalidArgumentException::class], |
125
|
|
|
'invalidIp' => ['999.999.999.999', null, \InvalidArgumentException::class], |
126
|
|
|
'invalidIpCidr' => ['999.999.999.999/22', null, \InvalidArgumentException::class], |
127
|
|
|
'shortestIp' => ['::', 128], |
128
|
|
|
'ipv4' => ['127.0.0.1', 32], |
129
|
|
|
'ipv6' => ['::1', 128], |
130
|
|
|
'ipv4-negative' => ['127.0.0.1/-1', null, \InvalidArgumentException::class], |
131
|
|
|
'ipv4-min' => ['127.0.0.1/0', 0], |
132
|
|
|
'ipv4-normal' => ['127.0.0.1/13', 13], |
133
|
|
|
'ipv4-max' => ['127.0.0.1/32', 32], |
134
|
|
|
'ipv4-overflow' => ['127.0.0.1/33', null, \InvalidArgumentException::class], |
135
|
|
|
'ipv6-negative' => ['::1/-1', null, \InvalidArgumentException::class], |
136
|
|
|
'ipv6-min' => ['::1/0', 0], |
137
|
|
|
'ipv6-normal' => ['::1/72', 72], |
138
|
|
|
'ipv6-normalExpanded' => ['2001:0db8:85a3:0000:0000:8a2e:0370:7334/23', 23], |
139
|
|
|
'ipv6-normalIpv4Mapped' => ['::ffff:192.0.2.128/109', 109], |
140
|
|
|
'ipv6-max' => ['::1/128', 128], |
141
|
|
|
'ipv6-overflow' => ['::1/129', null, \InvalidArgumentException::class], |
142
|
|
|
]; |
143
|
|
|
} |
144
|
|
|
|
145
|
|
|
/** |
146
|
|
|
* @dataProvider getCidrBitsDataProvider |
147
|
|
|
*/ |
148
|
|
|
public function testGetCidrBits(string $ip, ?int $expectedCidr, ?string $expectedException = null): void |
149
|
|
|
{ |
150
|
|
|
if ($expectedException !== null) { |
151
|
|
|
$this->expectException($expectedException); |
152
|
|
|
} |
153
|
|
|
$this->assertSame($expectedCidr, IpHelper::getCidrBits($ip)); |
154
|
|
|
} |
155
|
|
|
} |
156
|
|
|
|