You are here

function drupal_urlencode in Drupal 4

Same name and namespace in other branches
  1. 5 includes/common.inc \drupal_urlencode()
  2. 6 includes/common.inc \drupal_urlencode()

Wrapper around urlencode() which avoids Apache quirks.

Should be used when placing arbitrary data in an URL. Note that Drupal paths are urlencoded() when passed through url() and do not require urlencoding() of individual components.

Notes:

  • For esthetic reasons, we do not escape slashes. This also avoids a 'feature' in Apache where it 404s on any path containing '%2F'.
  • mod_rewrite unescapes %-encoded ampersands, hashes, and slashes when clean URLs are used, which are interpreted as delimiters by PHP. These characters are double escaped so PHP will still see the encoded version.
  • With clean URLs, Apache changes '//' to '/', so every second slash is double escaped.

Parameters

$text: String to encode

Related topics

3 calls to drupal_urlencode()
drupal_query_string_encode in includes/common.inc
Parse an array into a valid urlencoded query string.
theme_comment_post_forbidden in modules/comment.module
url in includes/common.inc
Generate a URL from a Drupal menu path. Will also pass-through existing URLs.

File

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

Code

function drupal_urlencode($text) {
  if (variable_get('clean_url', '0')) {
    return str_replace(array(
      '%2F',
      '%26',
      '%23',
      '//',
    ), array(
      '/',
      '%2526',
      '%2523',
      '/%252F',
    ), urlencode($text));
  }
  else {
    return str_replace('%2F', '/', urlencode($text));
  }
}