file_save_data

Versions
4.6 – 6: file_save_data($data, $dest, $replace = FILE_EXISTS_RENAME)
7: file_save_data($data, $destination = NULL, $replace = FILE_EXISTS_RENAME)

Save a string to the specified destination.

Parameters

$data A string containing the contents of the file.

$dest A string containing the destination location.

$replace Replace behavior when the destination file already exists.

FILE_EXISTS_REPLACE - Replace the existing file
FILE_EXISTS_RENAME - Append _{incrementing number} until the filename is unique
FILE_EXISTS_ERROR - Do nothing and return FALSE.

Return value

A string containing the resulting filename or 0 on error

▸ 5 functions call file_save_data()

▾ 5 functions call file_save_data()

blogapi_metaweblog_new_media_object in modules/blogapi/blogapi.module: Blogging API callback. Inserts a file into Drupal.
drupal_build_css_cache in includes/common.inc: Aggregate and optimize CSS files, putting them in the files directory.
drupal_build_js_cache in includes/common.inc: Aggregate JS files, putting them in the files directory.
_color_save_stylesheet in modules/color/color.module: Save the rewritten stylesheet to disk.
_locale_rebuild_js in includes/locale.inc: (Re-)Creates the JavaScript translation file for a language.

Code

includes/file.inc, line 759

<?php
function file_save_data($data, $dest, $replace = FILE_EXISTS_RENAME) {
  $temp = file_directory_temp();
  // On Windows, tempnam() requires an absolute path, so we use realpath().
  $file = tempnam(realpath($temp), 'file');
  if (!$fp = fopen($file, 'wb')) {
    drupal_set_message(t('The file could not be created.'), 'error');
    return 0;
  }
  fwrite($fp, $data);
  fclose($fp);

  if (!file_move($file, $dest, $replace)) {
    return 0;
  }

  return $file;
}
?>