function drupal_get_form

Returns a renderable form array for a given form ID.

This function should be used instead of drupal_build_form() when $form_state is not needed (i.e., when initially rendering the form) and is often used as a menu callback.


$form_id: The unique string identifying the desired form. If a function with that name exists, it is called to build the form array. Modules that need to generate the same form (or very similar forms) using different $form_ids can implement hook_forms(), which maps different $form_id values to the proper form constructor function. Examples may be found in node_forms(), and search_forms(). hook_forms() can also be used to define forms in classes.

...: Any additional arguments are passed on to the functions called by drupal_get_form(), including the unique form constructor function. For example, the node_edit form requires that a node object is passed in here when it is called. These are available to implementations of hook_form_alter() and hook_form_FORM_ID_alter() as the array $form_state['build_info']['args'].

Return value

The form array.

See also


Related topics

49 calls to drupal_get_form()
authorize.php in drupal/authorize.php
Administrative script for running authorized file operations.
block_admin_display in drupal/modules/block/
Menu callback for admin/structure/block.
book_outline in drupal/modules/book/
Menu callback: Shows the outline form for a single node.
comment_admin in drupal/modules/comment/
Menu callback; present an administrative comment listing.
comment_confirm_delete_page in drupal/modules/comment/
Page callback for comment deletions.

... See full list

32 string references to 'drupal_get_form'
aggregator_menu in drupal/modules/aggregator/aggregator.module
Implements hook_menu().
ajax_forms_test_menu in drupal/modules/simpletest/tests/ajax_forms_test.module
Implements hook_menu().
batch_test_menu in drupal/modules/simpletest/tests/batch_test.module
Implement hook_menu().
block_menu in drupal/modules/block/block.module
Implements hook_menu().
book_menu in drupal/modules/book/book.module
Implements hook_menu().

... See full list


drupal/includes/, line 123
Functions for form and batch generation and processing.


function drupal_get_form($form_id) {
  $form_state = array();
  $args = func_get_args();

  // Remove $form_id from the arguments.
  $form_state['build_info']['args'] = $args;
  return drupal_build_form($form_id, $form_state);