Caricamento dell'immagine in un modulo personalizzato

Sto scrivendo un modulo personalizzato e ne ho bisogno per caricare un'immagine. Ho problemi a trovare una buona documentazione su questo, ma penso di essere vicino.

Cosa mi sto perdendo? $ file restituisce false nell'invio del modulo.

function mymodule_custom_content_block_form($form_state){
    $form = array();
    $form['custom_content_block_text'] = array(
        '#type' => 'textarea',
        '#title' => t('Block text'),
        '#default_value' => variable_get('mymodule_custom_content_block_text'),
        '#required' => true,
    );
    $form['custom_content_block_image'] = array(
        '#type' => 'file',
        '#name' => 'custom_content_block_image',
        '#title' => t('Block image'),
        '#size' => 40,
        '#description' => t("Image should be less than 400 pixels wide and in JPG format."),
    );  
    $form['submit'] = array(
        '#type' => 'submit',
        '#value' => t('Update'),
    );
    return $form;
}

function mymodule_custom_content_block_form_submit($form, &$form_state){
    if(isset($form_state['values']['custom_content_block_image'])){
        $validators = array('file_validate_extensions' => array('jpg jpeg'));
        $file = file_save_upload('custom_content_block_image', $validators, 'public://');
        if($file == false){
            drupal_set_message(t("Error saving image."), $type = "error", $repeat = false);
        }
        else{
            $file->status = FILE_STATUS_PERMANENT;
            $file = file_save($file);   
        }
    }
    variable_set('mymodule_custom_content_block_text', $form_state['values']['custom_content_block_text']);
    drupal_set_message(t('Custom Content Block has been updated.'));
}

Se non ti dispiace dire che lo stai facendo nel modo più duro. Drupal ha un managed_filetipo di elemento che gestisce la maggior parte di questa logica per te:

function mymodule_custom_content_block_form($form, &$form_state) {
  $form['custom_content_block_image'] = array(
    '#type' => 'managed_file',
    '#name' => 'custom_content_block_image',
    '#title' => t('Block image'),
    '#size' => 40,
    '#description' => t("Image should be less than 400 pixels wide and in JPG format."),
    '#upload_location' => 'public://'
  ); 

  return $form; 
}

function mymodule_custom_content_block_form_submit($form, &$form_state) {
  if (isset($form_state['values']['custom_content_block_image'])) {
    $file = file_load($form_state['values']['custom_content_block_image']);

    $file->status = FILE_STATUS_PERMANENT;

    file_save($file);
  }
}

Con la risposta di Clive la mia immagine è stata cancellata dopo 6 ore. Quindi se qualcuno ha riscontrato lo stesso problema che ho avuto. Ecco la soluzione (dalla risposta di Clive con una piccola aggiunta).

function mymodule_custom_content_block_form($form, &$form_state) {
  $form['custom_content_block_image'] = array(
    '#type' => 'managed_file',
    '#name' => 'custom_content_block_image',
    '#title' => t('Block image'),
    '#size' => 40,
    '#description' => t("Image should be less than 400 pixels wide and in JPG format."),
    '#upload_location' => 'public://'
  ); 

  return $form; 
}

function mymodule_custom_content_block_form_submit($form, &$form_state) {
  if (isset($form_state['values']['custom_content_block_image'])) {
    $file = file_load($form_state['values']['custom_content_block_image']);

    $file->status = FILE_STATUS_PERMANENT;

    $file_saved =file_save($file);
    // Record that the module is using the file. 
    file_usage_add($file_saved, 'mymodule_custom_content_block_form', 'custom_content_block_image', $file_saved->fid); 
  }
}

La soluzione è aggiungere file_usage_add. Dalla documentazione API:

Nota: i nuovi file vengono caricati con uno stato 0 e vengono trattati come file temporanei che vengono rimossi dopo 6 ore tramite cron. Il modulo è responsabile della modifica dello stato degli oggetti $ file in FILE_STATUS_PERMANENT e del salvataggio del nuovo stato nel database. Qualcosa come il seguente all'interno del gestore di invio dovrebbe fare il trucco.

Vedi: https://api.drupal.org/api/drupal/developer%21topics%21forms_api_reference.html/7.x#managed_file

Questo attributo deve essere aggiunto al modulo affinché funzioni con i caricamenti di file.

$form['#attributes']['enctype'] = "multipart/form-data";