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

Description

Parameters

$maybe_ipstring

A suspected IP address.

Return

int|false

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

Uses · 1

• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.

Used by · 3

• WP_Http_Streams::verify_ssl_certificate()Verifies the received SSL certificate against its Common Names and subjectAltName fields.
• wp_notify_moderator()Notifies the moderator of the site about a new comment that is awaiting approval.
• wp_notify_postauthor()Notifies an author (and/or others) of a comment/trackback/pingback on a post.

Source

View on Trac ↗View on GitHub ↗

1110	public static function is_ip_address( $maybe_ip ) {1111		if ( preg_match( '/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/', $maybe_ip ) ) {1112			return 4;1113		}1114 1115		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, ' []' ) ) ) {1116			return 6;1117		}1118 1119		return false;1120	}

History

Introduced in 3.7.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/class-wp-http.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.