WP_Http::is_ip_address() WordPress Method
The WP_Http::is_ip_address() method is used to check if a given string is an IP address. This can be useful for validating user input, or for checking if a given IP address is allowed to access a certain resource.
WP_Http::is_ip_address( string $maybe_ip ) #
Determines if a specified string represents an IP address or not.
Description
This function also detects the type of the IP address, returning either ‘4’ or ‘6’ to represent a IPv4 and IPv6 address respectively. This does not verify if the IP is a valid IP, only that it appears to be an IP address.
Parameters
- $maybe_ip
(string)(Required)A suspected IP address.
Return
(int|false) Upon success, '4' or '6' to represent a IPv4 or IPv6 address, false upon failure
Source
File: wp-includes/class-wp-http.php
public static function is_ip_address( $maybe_ip ) {
if ( preg_match( '/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/', $maybe_ip ) ) {
return 4;
}
if ( false !== strpos( $maybe_ip, ':' ) && preg_match( '/^(((?=.*(::))(?!.*\3.+\3))\3?|([\dA-F]{1,4}(\3|:\b|$)|\2))(?4){5}((?4){2}|(((2[0-4]|1\d|[1-9])?\d|25[0-5])\.?\b){4})$/i', trim( $maybe_ip, ' []' ) ) ) {
return 6;
}
return false;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 3.7.0 | Introduced. |