Functions that are wrappers or custom implementations of PHP functions.
Certain PHP functions should not be used in Drupal. Instead, Drupal's replacement functions should be used.
For example, for improved or more secure UTF8-handling, or RFC-compliant handling of URLs in Drupal.
For ease of use and memorizing, all these wrapper functions use the same name as the original PHP function, but prefixed with "drupal_". Beware, however, that not all wrapper functions support the same arguments as the original functions.
You should always use these wrapper functions in your code.
Wrong:
$my_substring = substr($original_string, 0, 5);
Correct:
$my_substring = drupal_substr($original_string, 0, 5);
Name | Location | Description |
---|---|---|
drupal_basename |
drupal/ |
Gets the filename from a given path. |
drupal_chmod |
drupal/ |
Sets the permissions on a file or directory. |
drupal_dirname |
drupal/ |
Gets the name of the directory from a given path. |
drupal_http_build_query |
drupal/ |
Parses an array into a valid, rawurlencoded query string. |
drupal_json_decode |
drupal/ |
Converts an HTML-safe JSON string into its PHP equivalent. |
drupal_json_encode |
drupal/ |
Converts a PHP variable into its JavaScript equivalent. |
drupal_mkdir |
drupal/ |
Creates a directory using Drupal's default mode. |
drupal_move_uploaded_file |
drupal/ |
Moves an uploaded file to a new location. |
drupal_parse_url |
drupal/ |
Parses a URL string into its path, query, and fragment components. |
drupal_realpath |
drupal/ |
Resolves the absolute filepath of a local URI or filepath. |
drupal_register_shutdown_function |
drupal/ |
Registers a function for execution on shutdown. |
drupal_rmdir |
drupal/ |
Removes a directory. |
drupal_session_regenerate |
drupal/ |
Called when an anonymous user becomes authenticated or vice-versa. |
drupal_session_start |
drupal/ |
Starts a session forcefully, preserving already set session data. |
drupal_set_time_limit |
drupal/ |
Attempts to set the PHP maximum execution time. |
drupal_strlen |
drupal/ |
Counts the number of characters in a UTF-8 string. |
drupal_strtolower |
drupal/ |
Lowercase a UTF-8 string. |
drupal_strtoupper |
drupal/ |
Uppercase a UTF-8 string. |
drupal_substr |
drupal/ |
Cuts off a piece of a string based on character indices and counts. |
drupal_tempnam |
drupal/ |
Creates a file with a unique filename in the specified directory. |
drupal_ucfirst |
drupal/ |
Capitalizes the first letter of a UTF-8 string. |
drupal_unlink |
drupal/ |
Deletes a file. |
drupal_xml_parser_create |
drupal/ |
Prepares a new XML parser. |
php_eval |
drupal/ |
Evaluates a string of PHP code. |