wp_extract_urls( string $content )

Use RegEx to extract URLs from arbitrary content.

Contents

Parameters
Return
Source
Related
- Used By
Changelog
User Contributed Notes

Parameters

$content: (string) (Required) Content to extract URLs from.

Return

(string[]) Array of URLs found in passed string.

Source

File: wp-includes/functions.php

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 );
}

Expand full source code Collapse full source code View on Trac View on GitHub

Used By

Used By
Used By	Description
wp-includes/functions.php: do_enclose()	Check content for video and audio links to add as enclosures.
wp-includes/comment.php: pingback()	Pings back the links found in a post.

Changelog

Changelog
Version	Description
6.0.0	Fixes support for HTML entities (Trac 30580).
3.7.0	Introduced.

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Contributed by Sean Leavey — 1 year ago
This doesn’t work for localhost URLs without TLDs:
```
<a href="http://localhost.com:8889/?p=9">hi</a>  // Matches.
<a href="http://localhost:8889/?p=9">hi</a>      // Doesn't match.
```
(See this ticket.)
Log in to add feedback

0

Contributed by Codex — 6 years ago

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.