Functions to validate user input.
Functions & methods
| Name | Description |
|---|---|
| base_path | Returns the base URL path of the Drupal installation. At the very least, this will always default to /. |
| check_file | |
| check_url | Prepare a URL for use in an HTML attribute. Strips harmful protocols. |
| drupal_add_css | Adds a CSS file to the stylesheet queue. |
| drupal_add_js | Add a JavaScript file, setting or inline code to the page. |
| drupal_add_link | Add a <link> tag to the page's HEAD. |
| drupal_attributes | Format an attribute string to insert in a tag. |
| drupal_build_css_cache | Aggregate and optimize CSS files, putting them in the files directory. |
| drupal_clear_css_cache | Delete all cached CSS files. |
| drupal_clone | Provide a substitute clone() function for PHP4. |
| drupal_cron_cleanup | Shutdown function for cron cleanup. |
| drupal_cron_run | Executes a cron run when called |
| drupal_eval | Evaluate a string of PHP code. |
| drupal_get_css | Returns a themed representation of all stylesheets that should be attached to the page. It loads the CSS in order, with 'core' CSS first, then 'module' CSS, then 'theme' CSS files. This ensures proper cascading of styles… |
| drupal_get_js | Returns a themed presentation of all JavaScript code for the current page. References to JavaScript files are placed in a certain order: first, all 'core' files, then all 'module' and finally all 'theme' JavaScript… |
| drupal_get_path | Returns the path to a system item (module, theme, etc.). |
| drupal_get_private_key | Ensure the private key variable used to generate tokens is set. |
| drupal_get_token | Generate a token based on $value, the current user session and private key. |
| drupal_mail | Send an e-mail message, using Drupal variables and default settings. More information in the PHP function reference for mail() |
| drupal_map_assoc | Form an associative array from a linear array. |
| drupal_page_footer | Perform end-of-request tasks. |
| drupal_render | Renders HTML given a structured array tree. Recursively iterates over each of the array elements, generating HTML code. This function is usually called from within a another function, like drupal_get_form() or node_view(). |
| drupal_system_listing | Returns an array of files objects of the given type from the site-wide directory (i.e. modules/), the all-sites directory (i.e. sites/all/modules/), the profiles directory, and site-specific directory (i.e. sites/somesite/modules/). The returned array… |
| drupal_to_js | Converts a PHP variable into its Javascript equivalent. |
| drupal_urlencode | Wrapper around urlencode() which avoids Apache quirks. |
| drupal_valid_token | Validate a token based on $value, the current user session and private key. |
| element_child | Check if the key is a child. |
| element_children | Get keys of a structured array tree element that are not properties (i.e., do not begin with '#'). |
| element_properties | Get properties of a structured array element. Properties begin with '#'. |
| element_property | Check if the key is a property. |
| flood_is_allowed | Check if the current visitor (hostname/IP) is allowed to proceed with the specified event. The user is allowed to proceed if he did not trigger the specified event more than $threshold times per hour. |
| flood_register_event | Register an event for the current visitor (hostname/IP) to the flood control mechanism. |
| format_date | Format a date with the given configured format or a custom format string. |
| format_interval | Format a time interval with the requested granularity. |
| format_plural | Format a string containing a count of items. |
| format_rss_channel | Formats an RSS channel. |
| format_rss_item | Format a single RSS item. |
| format_size | Generate a string representation for the given byte count. |
| format_xml_elements | Format XML elements. |
| l | Format an internal Drupal link. |
| page_set_cache | Store the current page in the cache. |
| parse_size | Parse a given byte count. |
| url | Generate a URL from a Drupal menu path. Will also pass-through existing URLs. |
| valid_email_address | Verify the syntax of the given e-mail address. |
| valid_url | Verify the syntax of the given URL. |
| xmlrpc | Performs one or more XML-RPC request(s). |
| _drupal_add_js | Helper function for drupal_add_js(). |
| _drupal_bootstrap_full | |
| _element_sort | Function used by uasort in drupal_render() to sort structured arrays by weight. |
Groups
| Name | Description |
|---|---|
| Formatting | Functions to format numbers, strings, dates, etc. |
File
- includes/
common.inc, line 893 - Common functions that many Drupal modules will need to reference.
Comments
Additional validations
I spent some time mulling over all this stuff and wasn't able to find anything on customized validations. I presume this is because php functions like
preg_matchwork so well. Based on the assumption that a drupal version ofpreg_matchdoesn't exist, here's how you would make sure that a given string contains ONLY, for example, numbers and letters://validate function called after submission of my form
function mymenu_validate($form, &$form_state) {
/*
suppose the user wrote something into the "userinput" field,
and we want to ensure it only contains numbers and letters.
To do this we use the expression /^[a-zA-Z0-9]+$/
*/
if (!(preg_match("/^[a-zA-Z0-9]+$/", $form_state['values']['userinput']))) {
//the user input contained characters other than letters and numbers
}
else {
//the user input contained only letters and numbers
}
}
If you're as confused as I was about the expressions, check this out: http://www.hotscripts.com/forums/php/21391-help-preg_match.html