function valid_url

Verifies the syntax of the given URL.

This function should only be used on actual URLs. It should not be used for Drupal menu paths, which can contain arbitrary characters. Valid values per RFC 3986.

Parameters

$url: The URL to verify.

$absolute: Whether the URL is absolute (beginning with a scheme such as "http:").

Return value

TRUE if the URL is in a valid format.

Related topics

Input validation
Functions to validate user input.
7 calls to valid_url()
aggregator_form_opml_submit in drupal/core/modules/aggregator/aggregator.admin.inc
Form submission handler for aggregator_form_opml().
form_validate_url in drupal/core/includes/form.inc
Form element validation handler for #type 'url'.
UrlTest::testDrupalParseUrl in drupal/core/modules/system/lib/Drupal/system/Tests/Common/UrlTest.php
Tests drupal_parse_url().
ValidUrlUnitTest::testInvalidAbsolute in drupal/core/modules/system/lib/Drupal/system/Tests/Common/ValidUrlUnitTest.php
Tests invalid absolute URLs.
ValidUrlUnitTest::testInvalidRelative in drupal/core/modules/system/lib/Drupal/system/Tests/Common/ValidUrlUnitTest.php
Tests invalid relative URLs.

... See full list

File

drupal/core/includes/common.inc, line 1114
Common functions that many Drupal modules will need to reference.

Code

function valid_url($url, $absolute = FALSE) {
  if ($absolute) {
    return (bool) preg_match("\n      /^                                                      # Start at the beginning of the text\n      (?:ftp|https?|feed):\\/\\/                                # Look for ftp, http, https or feed schemes\n      (?:                                                     # Userinfo (optional) which is typically\n        (?:(?:[\\w\\.\\-\\+!\$&'\\(\\)*\\+,;=]|%[0-9a-f]{2})+:)*      # a username or a username and password\n        (?:[\\w\\.\\-\\+%!\$&'\\(\\)*\\+,;=]|%[0-9a-f]{2})+@          # combination\n      )?\n      (?:\n        (?:[a-z0-9\\-\\.]|%[0-9a-f]{2})+                        # A domain name or a IPv4 address\n        |(?:\\[(?:[0-9a-f]{0,4}:)*(?:[0-9a-f]{0,4})\\])         # or a well formed IPv6 address\n      )\n      (?::[0-9]+)?                                            # Server port number (optional)\n      (?:[\\/|\\?]\n        (?:[\\w#!:\\.\\?\\+=&@\$'~*,;\\/\\(\\)\\[\\]\\-]|%[0-9a-f]{2})   # The path and query (optional)\n      *)?\n    \$/xi", $url);
  }
  else {
    return (bool) preg_match("/^(?:[\\w#!:\\.\\?\\+=&@\$'~*,;\\/\\(\\)\\[\\]\\-]|%[0-9a-f]{2})+\$/i", $url);
  }
}