WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_extract_urls()

wp_extract_urls( string $content ): string[]

In this article

Back to top

Uses RegEx to extract URLs from arbitrary content.

Parameters

$contentstringrequired
Content to extract URLs from.

Return

string[] Array of URLs found in passed string.

Source

function wp_extract_urls( $content ) {
	preg_match_all(
		"#([\"']?)("
			. '(?:([\w-]+:)?//?)'
			. '[^\s()<>]+'
			. '[.]'
			. '(?:'
				. '\([\w\d]+\)|'
				. '(?:'
					. "[^`!()\[\]{}:'\".,<>«»“”‘’\s]|"
					. '(?:[:]\d+)?/?'
				. ')+'
			. ')'
		. ")\\1#",
		$content,
		$post_links
	);

	$post_links = array_unique(
		array_map(
			static function ( $link ) {
				// Decode to replace valid entities, like &amp;.
				$link = html_entity_decode( $link );
				// Maintain backward compatibility by removing extraneous semi-colons (`;`).
				return str_replace( ';', '', $link );
			},
			$post_links[2]
		)
	);

	return array_values( $post_links );
}

View all references View on Trac View on GitHub

Used byDescription
do_enclose()wp-includes/functions.php

Checks content for video and audio links to add as enclosures.

pingback()wp-includes/comment.php

Pings back the links found in a post.

Changelog

VersionDescription
6.0.0Fixes support for HTML entities (Trac 30580).
3.7.0Introduced.

User Contributed Notes

  2. Skip to note 4 content
    Codex
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Example

    This Code:

    $string = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin elementum quis lacus in accumsan. Sed sed lacus odio. Sed ullamcorper, nibh et dignissim convallis, lacus tellus pellentesque ipsum, et interdum purus urna ultricies justo. Phasellus blandit eros nec lectus vestibulum consequat. Cras faucibus turpis sed ante commodo cursus. Duis vitae ligula vulputate, varius mi vel, facilisis est. Nulla id mollis ipsum. Nunc faucibus augue vel erat luctus sodales. Curabitur gravida vulputate nulla sed aliquam. Ut posuere mollis mauris, et placerat diam cursus vitae. Vivamus eros arcu, lobortis id sapien at, tempus tristique nunc. Praesent sollicitudin vulputate lorem, vitae vestibulum nisi pretium non. http://example.com is a cool site.';

$urls = wp_extract_urls( $string );

    Will return an array like this:

    array( 0 => 'http://example.com' )

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