longman / ip-tools
PHP IP Tools for manipulation with IPv4 and IPv6
Installs: 186 473
Dependents: 8
Suggesters: 0
Security: 0
Stars: 149
Watchers: 9
Forks: 10
Open Issues: 4
Requires
- php: >=5.5
- ext-bcmath: *
Requires (Dev)
- phpspec/phpspec: ~2.1
- phpunit/phpunit: ~4.1
- squizlabs/php_codesniffer: ~2.3
README
Universal IP Tools for manipulation on IPv4 and IPv6.
Require this package with Composer
Install this package through Composer.
Edit your project's composer.json
file to require
longman/ip-tools
.
Create composer.json file:
{ "name": "yourproject/yourproject", "type": "project", "require": { "longman/ip-tools": "~1.1.0" } }
And run composer update
Or run a command in your command line:
composer require longman/ip-tools
Usage
<?php $loader = require __DIR__.'/vendor/autoload.php'; use Longman\IPTools\Ip; // Validating $status = Ip::isValid('192.168.1.1'); // true $status = Ip::isValid('192.168.1.256'); // false // ip2long, long2ip /// IPv4 $long = Ip::ip2long('192.168.1.1'); // 3232235777 $dec = Ip::long2ip('3232235777'); // 192.168.1.1 /// IPv6 $long = Ip::ip2long('fe80:0:0:0:202:b3ff:fe1e:8329'); // 338288524927261089654163772891438416681 $dec = Ip::long2ip('338288524927261089654163772891438416681', true); // fe80::202:b3ff:fe1e:8329 // Matching /// IPv4 $status = Ip::match('192.168.1.1', '192.168.1.*'); // true $status = Ip::match('192.168.1.1', '192.168.*.*'); // true $status = Ip::match('192.168.1.1', '192.168.*.*'); // true $status = Ip::match('192.168.1.1', '192.168.0.*'); // false $status = Ip::match('192.168.1.1', '192.168.1/24'); // true $status = Ip::match('192.168.1.1', '192.168.1.1/255.255.255.0'); // true $status = Ip::match('192.168.1.1', '192.168.0/24'); // false $status = Ip::match('192.168.1.1', '192.168.0.0/255.255.255.0'); // false $status = Ip::match('192.168.1.5', '192.168.1.1-192.168.1.10'); // true $status = Ip::match('192.168.5.5', '192.168.1.1-192.168.10.10'); // true $status = Ip::match('192.168.5.5', '192.168.6.1-192.168.6.10'); $status = Ip::match('192.168.1.1', array('122.128.123.123', '192.168.1.*', '192.168.123.124')); // true $status = Ip::match('192.168.1.1', array('192.168.123.*', '192.168.123.124')); /// IPv6 $status = Ip::match('2001:cdba:0000:0000:0000:0000:3257:9652', '2001:cdba:0000:0000:0000:0000:3257:*'); // true $status = Ip::match('2001:cdba:0000:0000:0000:0000:3257:9652', '2001:cdba:0000:0000:0000:0000:*:*'); // true $status = Ip::match('2001:cdba:0000:0000:0000:0000:3257:9652', '2001:cdba:0000:0000:0000:0000:3257:1234-2001:cdba:0000:0000:0000:0000:3257:9999'); // true $status = Ip::match('2001:cdba:0000:0000:0000:0000:3258:9652', '2001:cdba:0000:0000:0000:0000:3257:*'); // false $status = Ip::match('2001:cdba:0000:0000:0000:1234:3258:9652', '2001:cdba:0000:0000:0000:0000:*:*'); // false $status = Ip::match('2001:cdba:0000:0000:0000:0000:3257:7778', '2001:cdba:0000:0000:0000:0000:3257:1234-2001:cdba:0000:0000:0000:0000:3257:7777'); // false
This code is available on Github. Pull requests are welcome.
Troubleshooting
If you like living on the edge, please report any bugs you find on the PHP IP Tools issues page.
Contributing
See CONTRIBUTING.md for information.
License
Please see the LICENSE included in this repository for a full copy of the MIT license, which this project is licensed under.
Credits
Full credit list in CREDITS