WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_Http::is_ip_address()

WP_Http::is_ip_address( string $maybe_ip ): int|false

In this article

Back to top

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 an 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_ipstringrequired
A suspected IP address.

Return

int|false Upon success, '4' or '6' to represent an IPv4 or IPv6 address, false upon failure.

Source

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 ( str_contains( $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;
}

View all references View on Trac View on GitHub

Used byDescription
wp_notify_postauthor()wp-includes/pluggable.php

Notifies an author (and/or others) of a comment/trackback/pingback on a post.

wp_notify_moderator()wp-includes/pluggable.php

Notifies the moderator of the site about a new comment that is awaiting approval.

WP_Http_Streams::verify_ssl_certificate()wp-includes/class-wp-http-streams.php

Verifies the received SSL certificate against its Common Names and subjectAltName fields.

Changelog

VersionDescription
3.7.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.