function file_usage_list
7.x file.inc | file_usage_list(stdClass $file) |
Determines where a file is used.
Parameters
$file: A file object.
Return value
A nested array with usage data. The first level is keyed by module name, the second by object type and the third by the object id. The value of the third level contains the usage count.
See also
Related topics
6 calls to file_usage_list()
- FileDeleteTest::testInUse in drupal-7.x/
modules/ simpletest/ tests/ file.test - Tries deleting a file that is in use.
- FileUsageTest::testGetUsage in drupal-7.x/
modules/ simpletest/ tests/ file.test - Tests file_usage_list().
- file_delete in drupal-7.x/
includes/ file.inc - Deletes a file and its database record.
- file_field_delete_file in drupal-7.x/
modules/ file/ file.field.inc - Decrements the usage count for a file and attempts to delete it.
- file_managed_file_validate in drupal-7.x/
modules/ file/ file.module - An #element_validate callback for the managed_file element.
File
- drupal-7.x/
includes/ file.inc, line 642 - API for handling file uploads and server file management.
Code
function file_usage_list(stdClass $file) {
$result = db_select('file_usage', 'f')
->fields('f', array('module', 'type', 'id', 'count'))
->condition('fid', $file->fid)
->condition('count', 0, '>')
->execute();
$references = array();
foreach ($result as $usage) {
$references[$usage->module][$usage->type][$usage->id] = $usage->count;
}
return $references;
}