Skip to content

Laravel validation rules for checking IP addresses and networks

License

Notifications You must be signed in to change notification settings

miken32/NetworkRules

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A Collection of Rules
for the Reliable Validation
of
Internet Protocol Addreſſes,
Networks, and Subnets
which the author hopes will be found uſeful to
Laravel Programmers &c.

Installation

composer require miken32/network-rules

Available Validation Rules

Here is a list of the available rules and their usage.

In Network
IP Or Net
Netv4
Netv6
Private IP
Private IPv4
Private IPv6
Private Net
Routable IP
Routable IPv4
Routable IPv6
Routable Net
Routable Netv4
Routable Netv6

in_network:cidr,...

The field under validation must be an IP address within one of the given networks. The networks must be given in CIDR notation, and may be either IPv4 or IPv6 networks.

'ip4_address' => 'in_network:192.168.0.1/24',
'some_address' => 'in_network:192.168.0.0/24,192.168.1.0/24,192.168.2.0/24',
'ip6_address' => 'in_network:fd03:224f:a5c3:99ae::0/64'

ip_or_net

The field under validation must be an IP address or network in CIDR notation. The address or network may be either IPv4 or IPv6.

netv4:low,high

The field under validation must be an IPv4 network in CIDR notation. If provided, the number of bits in the mask must be between low and high.

'bounded_network'   => 'netv4:20,24',
'unbounded_network' => 'netv4'

netv6:low,high

The field under validation must be an IPv6 network in CIDR notation. If provided, the number of bits in the mask must be between low and high.

'bounded_network'   => 'netv6:56,64'
'unbounded_network' => 'netv6'

private_ip

The field under validation must be a private IPv4 or IPv6 address. Private addresses are defined as being within one of the following networks:

  • 10.0.0.0/8
  • 172.16.0.0/12
  • 192.168.0.0/16
  • fc00::/7

The following networks are considered reserved, not private. They are not considered valid by this rule:

  • 0.0.0.0/8
  • 127.0.0.0/8
  • 169.254.0.0/16
  • 240.0.0.0/4
  • ::/128
  • ::1/128
  • 2001:10::/28
  • 2001:db8::/32
  • 3ffe::/16
  • 5f00::/8
  • fe80::/10

private_ipv4

The field under validation must be a private IPv4 addresses. The networks considered private are described in the private_ip rule.

private_ipv6

The field under validation must be a private IPv6 addresses. The networks considered private are described in the private_ip rule.

private_net

The field under validation must be a private IP network in CIDR notation. The networks considered private are described in the private_ip rule.

routable_ip

The field under validation must be a globally routable IPv4 or IPv6 address. This excludes all private and reserved ranges, as detailed the the private_ip rule.

routable_ipv4

The field under validation must be a globally routable IPv4 address. This excludes all private and reserved ranges, as detailed the the private_ip rule.

routable_ipv6

The field under validation must be a globally routable IPv6 address. This excludes all private and reserved ranges, as detailed the the private_ip rule.

routable_net:low,high

The field under validation must be a globally routable IP network in CIDR notation. The network must not overlap any private or reserved ranges, as detailed the the private_ip rule. If provided, the number of bits in the mask must be between low and high.

routable_netv4:low,high

The field under validation must be a globally routable IPv4 network in CIDR notation. The network must not overlap any private or reserved ranges, as detailed the the private_ip rule. If provided, the number of bits in the mask must be between low and high.

routable_netv6:low,high

The field under validation must be a globally routable IPv6 network in CIDR notation. The network must not overlap any private or reserved ranges, as detailed the the private_ip rule. If provided, the number of bits in the mask must be between low and high.

Usage

The included validation rules can be used either as traditional string-based validation rules or as instantiated classes. The following code blocks perform identical validations.

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class MyFormRequest extends FormRequest
{
    public function rules(): array
    {
        return [

          'address'      => ['in_network:192.168.10.0/24'], // must be an IPv4 address in the specified network
          'subnet'       => ['netv4'], // must be an IPv4 CIDR network
          'ipv6_subnet'  => ['netv6:48,56'], // must be an IPv6 CIDR network between 48 and 56 bits
        ];
    }
}
<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Miken32\Validation\Network\Rules;

class AnotherFormRequest extends FormRequest
{
    public function rules(): array
    {
        return [
          'address'      => [new Rules\InNetwork('192.168.10.0/24')], // must be an IPv4 address in the specified network
          'subnet'       => [new Rules\Netv4()], // must be an IPv4 CIDR network
          'ipv6_subnet'  => [new Rules\Netv6(48, 56)], // must be an IPv6 CIDR network between 48 and 56 bits
        ];
    }
}