function file_unmanaged_save_data
7.x file.inc | file_unmanaged_save_data($data, $destination = NULL, $replace = FILE_EXISTS_RENAME) |
Saves a string to the specified destination without invoking file API.
This function is identical to file_save_data() except the file will not be saved to the {file_managed} table and none of the file_* hooks will be called.
Parameters
$data: A string containing the contents of the file.
$destination: A string containing the destination location. This must be a stream wrapper URI. If no value is provided, a randomized name will be generated and the file will be saved using Drupal's default files scheme, usually "public://".
$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 with the path of the resulting file, or FALSE on error.
See also
Related topics
10 calls to file_unmanaged_save_data()
- AggregatorTestCase::getEmptyOpml in drupal-7.x/
modules/ aggregator/ aggregator.test - Creates a valid but empty OPML file.
- AggregatorTestCase::getInvalidOpml in drupal-7.x/
modules/ aggregator/ aggregator.test - Creates an invalid OPML file.
- AggregatorTestCase::getValidOpml in drupal-7.x/
modules/ aggregator/ aggregator.test - Creates a valid OPML file from an array of feeds.
- drupal_build_css_cache in drupal-7.x/
includes/ common.inc - Aggregates and optimizes CSS files into a cache file in the files directory.
- drupal_build_js_cache in drupal-7.x/
includes/ common.inc - Aggregates JavaScript files into a cache file in the files directory.
File
- drupal-7.x/
includes/ file.inc, line 1933 - API for handling file uploads and server file management.
Code
function file_unmanaged_save_data($data, $destination = NULL, $replace = FILE_EXISTS_RENAME) {
// Write the data to a temporary file.
$temp_name = drupal_tempnam('temporary://', 'file');
if (file_put_contents($temp_name, $data) === FALSE) {
drupal_set_message(t('The file could not be created.'), 'error');
return FALSE;
}
// Move the file to its final destination.
return file_unmanaged_move($temp_name, $destination, $replace);
}