Form submit handlers with additional arguments

Question

For some requirement I need to pass additional information to form submit handler. In form api, while defining custom submit handler as

$additional_args = array();
$form['#submit'][] = 'my_submit_handler'

I expect to submit handler as

function my_submit_handler($form, &$form_state, $additional_args){

Answer 1

The submit handler is called by the drupal fapi, so you can't do something like that. Instead what you can do, is to add what you need, either to the $form, or to the $form_state. The usual approaches is to:

• Added a field to the form, type value to store the value. Done if you have the value in the form definition.

  $form['store'] = array(
    '#type' => 'value',
    '#value' => $value
  );
  

  This will be available in $form_state['values']['store'].

• Add the value to $form_state['storage'], done if you variables in your validation handle you want to transfer to your submit handler:

  // Validation.
  $form_state['storage']['value'] = $value;
  
  
  ...
  
  
  // Submit
  $value = $form_state['storage']['value'];
  // Need to unset stored values when not used anymore.
  unset($form_state['storage']['value']);
  

Answer 2

The suggested way to pass parameters to a submission handler set as in the code show is to use code similar to the following:

$form['#first_paramater'] = $value;
$form['#submit'][] = 'my_submit_handler';

The handler would retrieve the value as $form['#first_paramater']. To notice that, instead of #first_paramater, the code can use a different string, but it must start with #.

Normally it's not necessary to set a submission handler like the code does, but there are some cases where it is necessary, like to alter a form created by another module, or to set a different submission handler for each of the submission buttons present in a form.