Arquivo gerenciado: o arquivo usado no campo não pode ser referenciado

Estou tendo alguns problemas com o tipo de arquivo gerenciado . Sempre que tento editar e salvar um formulário com um elemento file_file, ocorre um erro: O arquivo usado no campo Imagem pode não ser referenciado.

Este é o código que estou usando:

function foo_form ($form, &$form_state, $foo) {  
  ...     
  $form['file'] = array(
    '#type' => 'managed_file',
    '#title' => t('Picture'),
    '#default_value' => (isset($foo->file->fid) ? $banner->foo->fid : ''),
    '#upload_location' => variable_get('foo_upload_location'),
  );

  if (isset($foo->file)) {
    $form['current_file'] = array(
      '#type' => 'hidden',
      '#value' => $foo->file->fid,
    );
  }
  ...
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Save'),
  );
  return $form;
 }

function foo_form_submit ($form, &$form_state) {
  $foo = (object)$form_state['values'];

  $current_file_set = isset($form_state['values']['current_file']);

  if ($form_state['values']['file'] != 0 && !$current_file_set) {
    // Load the file uploaded in the form.
    $file = file_load($form_state['values']['file']);

    $file->status = FILE_STATUS_PERMANENT;

    file_save($file);

    $foo->file = $file->fid;
  } else if ($form_state['values']['file'] != 0 && $current_file_set) {

    // If we are uploading a different picture, delete the old one and save the
    // new one. If not, don't do anything.
    if ($form_state['values']['current_file'] != $form_state['values']['file']) {
      file_delete(file_load($form_state['values']['current_file']));
      // Load the file uploaded in the form.
      $file = file_load($form_state['values']['file']);

      $file->status = FILE_STATUS_PERMANENT;

      file_save($file);

      $foo->file = $file->fid;
    }
  } else {
    file_delete(file_load($form_state['values']['current_file']));
    $foo->file = null;
  }

  ...
}

Rastreei o erro de volta à função file_managed_file_validate em modules / file / file.module, mas não sei nada sobre as referências de arquivo.

A solução é adicionar uma chamada a file_usage_add após o arquivo ser salvo. Essa chamada adiciona uma referência ao arquivo no banco de dados. A função file_managed_file_validate localizará a referência e não disparará o erro.

file_usage_add($file, 'foo', 'foo', $foo->id);

Isso não está documentado na API do formulário no exemplo do arquivo gerenciado .

Este problema está sendo discutido nos problemas de documentação do Drupal: link