Projet

Général

Profil

Paste
Télécharger (10,2 ko) Statistiques
| Branche: | Révision:

root / drupal7 / sites / all / modules / file_entity / file_entity.file.inc @ e013fa40

1
<?php
2

    
3
/**
4
 * @file
5
 * File hooks implemented by the File entity module.
6
 */
7

    
8
/**
9
 * Implements hook_file_presave().
10
 */
11
function file_entity_file_presave($file) {
12
  // Always ensure the filemime property is current.
13
  if (!empty($file->original) || empty($file->filemime)) {
14
    $file->filemime = file_get_mimetype($file->uri);
15
  }
16

    
17
  // The file type is used as a bundle key, and therefore, must not be NULL.
18
  // It defaults to FILE_TYPE_NONE when loaded via file_load(), but in case
19
  // file_save() is called on a new file object, default it here too.
20
  if (!isset($file->type)) {
21
    $file->type = FILE_TYPE_NONE;
22
  }
23

    
24
  // If the file isn't already assigned a real type, determine what type should
25
  // be assigned to it.
26
  if ($file->type === FILE_TYPE_NONE) {
27
    $type = file_get_type($file);
28
    if (isset($type)) {
29
      $file->type = $type;
30
    }
31
  }
32

    
33
  field_attach_presave('file', $file);
34

    
35
  // Fetch image dimensions.
36
  file_entity_metadata_fetch_image_dimensions($file);
37
}
38

    
39
/**
40
 * Implements hook_file_type().
41
 */
42
function file_entity_file_type($file) {
43
  $types = array();
44
  foreach (file_type_get_enabled_types() as $type) {
45
    if (file_entity_match_mimetypes($type->mimetypes, $file->filemime)) {
46
      $types[] = $type->type;
47
    }
48
  }
49

    
50
  return $types;
51
}
52

    
53
/**
54
 * Implements hook_file_insert().
55
 */
56
function file_entity_file_insert($file) {
57
  // Ensure field data is saved since file_save() does not in Drupal 7.
58
  field_attach_insert('file', $file);
59

    
60
  // Save file metadata.
61
  if (!empty($file->metadata)) {
62
    $query = db_insert('file_metadata')->fields(array('fid', 'name', 'value'));
63
    foreach ($file->metadata as $name => $value) {
64
      $query->values(array(
65
        'fid' => $file->fid,
66
        'name' => $name,
67
        'value' => serialize($value),
68
      ));
69
    }
70
    $query->execute();
71
  }
72

    
73
  // Clear any related field caches.
74
  file_entity_invalidate_field_caches($file);
75
}
76

    
77
/**
78
 * Implements hook_file_update().
79
 */
80
function file_entity_file_update($file) {
81
  // Ensure field data is saved since file_save() does not in Drupal 7.
82
  field_attach_update('file', $file);
83

    
84
  // Save file metadata.
85
  db_delete('file_metadata')->condition('fid', $file->fid)->execute();
86
  if (!empty($file->metadata)) {
87
    $query = db_insert('file_metadata')->fields(array('fid', 'name', 'value'));
88
    foreach ($file->metadata as $name => $value) {
89
      $query->values(array(
90
        'fid' => $file->fid,
91
        'name' => $name,
92
        'value' => serialize($value),
93
      ));
94
    }
95
    $query->execute();
96
  }
97

    
98
  if (module_exists('image') && file_entity_file_get_mimetype_type($file) == 'image' && $file->filesize && isset($file->original)) {
99
    if (!isset($file->metadata)) {
100
      $file->metadata = array();
101
    }
102

    
103
    if (!isset($file->original->metadata)) {
104
      if (!is_object($file->original)) {
105
        $file->original = new stdClass();
106
      }
107
      $file->original->metadata = array();
108
    }
109

    
110
    // If the file has changed dimensions or a new file has been uploaded,
111
    // update any image field reference to this file and flush image style
112
    // derivatives.
113
    $file->metadata += array('width' => NULL, 'height' => NULL);
114
    $file->original->metadata += array('width' => NULL, 'height' => NULL);
115
    if ($file->filesize != $file->original->filesize || $file->metadata['width'] != $file->original->metadata['width'] || $file->metadata['height'] != $file->original->metadata['height']) {
116
      _file_entity_update_image_field_dimensions($file);
117
    }
118

    
119
    // Flush image style derivatives whenever an image is updated.
120
    image_path_flush($file->uri);
121
  }
122

    
123
  // Clear any related field caches.
124
  file_entity_invalidate_field_caches($file);
125
}
126

    
127
/**
128
 * Implements hook_file_delete().
129
 */
130
function file_entity_file_delete($file) {
131
  field_attach_delete('file', $file);
132

    
133
  // This is safe to call since the file's records from the usage table have
134
  // not yet been deleted.
135
  file_entity_invalidate_field_caches($file);
136

    
137
  // Remove file metadata.
138
  db_delete('file_metadata')->condition('fid', $file->fid)->execute();
139

    
140
  // Remove this file from the search index if needed.
141
  // This code is implemented in file entity module rather than in search
142
  // module because file entity is implementing search module's API, not the
143
  // other way around.
144
  if (module_exists('search')) {
145
    search_reindex($file->fid, 'file');
146
  }
147
}
148

    
149
/**
150
 * Implements hook_file_mimetype_mapping_alter().
151
 */
152
function file_entity_file_mimetype_mapping_alter(&$mapping) {
153
  // Add support for mka and mkv.
154
  // @todo Remove when http://drupal.org/node/1443070 is fixed in core.
155
  $new_mappings['mka'] = 'audio/x-matroska';
156
  $new_mappings['mkv'] = 'video/x-matroska';
157

    
158
  // Add support for weba, webm, and webp.
159
  // @todo Remove when http://drupal.org/node/1443070 is fixed in core.
160
  $new_mappings['weba'] = 'audio/webm';
161
  $new_mappings['webm'] = 'video/webm';
162
  $new_mappings['webp'] = 'image/webp';
163

    
164
  foreach ($new_mappings as $extension => $mime_type) {
165
    if (!in_array($mime_type, $mapping['mimetypes'])) {
166
      // If the mime type does not already exist, add it.
167
      $mapping['mimetypes'][] = $mime_type;
168
    }
169

    
170
    // Get the index of the mime type and assign the extension to that key.
171
    $index = array_search($mime_type, $mapping['mimetypes']);
172
    $mapping['extensions'][$extension] = $index;
173
  }
174
}
175

    
176
/**
177
 * Implements hook_file_load().
178
 */
179
function file_entity_file_load($files) {
180
  // Add alt and title text to images.
181
  $alt = variable_get('file_entity_alt', '[file:field_file_image_alt_text]');
182
  $title = variable_get('file_entity_title', '[file:field_file_image_title_text]');
183

    
184
  $replace_options = array(
185
    'clear' => TRUE,
186
    'sanitize' => FALSE,
187
  );
188

    
189
  foreach ($files as $file) {
190
    $file->metadata = array();
191

    
192
    // Load alt and title text from fields.
193
    if (!empty($alt)) {
194
      $output = token_replace($alt, array('file' => $file), $replace_options);
195

    
196
      // @todo Remove once https://www.drupal.org/node/1713164 is fixed.
197
      // There is currently no way to get the raw alt text returned from the
198
      // token so we revert the encoding done during tokenization.
199
      $file->alt = decode_entities($output);
200
    }
201
    if (!empty($title)) {
202
      $output = token_replace($title, array('file' => $file), $replace_options);
203

    
204
      // @todo Remove once https://www.drupal.org/node/1713164 is fixed.
205
      // There is currently no way to get the raw title text returned from the
206
      // token so we revert the encoding done during tokenization.
207
      $file->title = decode_entities($output);
208
    }
209
  }
210

    
211
  // Load and unserialize metadata.
212
  $results = db_query("SELECT * FROM {file_metadata} WHERE fid IN (:fids)", array(':fids' => array_keys($files)));
213

    
214
  foreach ($results as $result) {
215
    $name = $result->name;
216

    
217
    // image.module required height and width to be properties of the file.
218
    if ($name == 'height' || $name == 'width') {
219
      $files[$result->fid]->$name = unserialize($result->value);
220
    }
221

    
222
    $files[$result->fid]->metadata[$name] = unserialize($result->value);
223
  }
224
}
225

    
226
/**
227
 * Fetch the dimensions of an image and store them in the file metadata array.
228
 */
229
function file_entity_metadata_fetch_image_dimensions($file) {
230
  // Prevent PHP notices when trying to read empty files.
231
  // @see http://drupal.org/node/681042
232
  if (!$file->filesize) {
233
    return;
234
  }
235

    
236
  // Do not bother proceeding if this file does not have an image mime type.
237
  if (file_entity_file_get_mimetype_type($file) != 'image') {
238
    return;
239
  }
240

    
241
  // We have a non-empty image file.
242
  $image_info = image_get_info($file->uri);
243
  if ($image_info) {
244
    $file->metadata['width'] = $image_info['width'];
245
    $file->metadata['height'] = $image_info['height'];
246
  }
247
  else {
248
    // Fallback to NULL values.
249
    $file->metadata['width'] = NULL;
250
    $file->metadata['height'] = NULL;
251
  }
252
}
253

    
254
/**
255
 * Update the image dimensions stored in any image fields for a file.
256
 *
257
 * @param object $file
258
 *   A file object that is an image.
259
 *
260
 * @see http://drupal.org/node/1448124
261
 */
262
function _file_entity_update_image_field_dimensions($file) {
263
  // Prevent PHP notices when trying to read empty files.
264
  // @see http://drupal.org/node/681042
265
  if (!$file->filesize) {
266
    return;
267
  }
268

    
269
  // Do not bother proceeding if this file does not have an image mime type.
270
  if (file_entity_file_get_mimetype_type($file) != 'image') {
271
    return;
272
  }
273

    
274
  // Find all image field enabled on the site.
275
  $image_fields = _file_entity_get_fields_by_type('image');
276

    
277
  foreach ($image_fields as $image_field) {
278
    $query = new EntityFieldQuery();
279
    $query->fieldCondition($image_field, 'fid', $file->fid);
280
    $results = $query->execute();
281

    
282
    foreach ($results as $entity_type => $entities) {
283
      $entities = entity_load($entity_type, array_keys($entities));
284
      foreach ($entities as $entity) {
285
        foreach ($entity->{$image_field} as $langcode => $items) {
286
          foreach ($items as $delta => $item) {
287
            if ($item['fid'] == $file->fid) {
288
              $entity->{$image_field}[$langcode][$delta]['width'] = $file->metadata['width'];
289
              $entity->{$image_field}[$langcode][$delta]['height'] = $file->metadata['height'];
290
            }
291
          }
292
        }
293

    
294
        // Save the updated field column values.
295
        _file_entity_entity_fields_update($entity_type, $entity);
296
      }
297
    }
298
  }
299
}
300

    
301
/**
302
 * Update an entity's field values without changing anything on the entity.
303
 */
304
function _file_entity_entity_fields_update($entity_type, $entity) {
305
  list($id) = entity_extract_ids($entity_type, $entity);
306
  if (empty($id)) {
307
    throw new Exception(t('Cannot call _file_entity_update_entity_fields() on a new entity.'));
308
  }
309

    
310
  // Some modules use the original property.
311
  if (!isset($entity->original)) {
312
    $entity->original = $entity;
313
  }
314

    
315
  // Ensure that file_field_update() will not trigger additional usage.
316
  unset($entity->revision);
317

    
318
  // Invoke the field presave and update hooks.
319
  field_attach_presave($entity_type, $entity);
320
  field_attach_update($entity_type, $entity);
321

    
322
  // Clear the cache for this entity now.
323
  entity_get_controller($entity_type)->resetCache(array($id));
324
}
325

    
326
/**
327
 * Implements hook_file_metadata_info().
328
 */
329
function file_entity_file_metadata_info() {
330
  $info['width'] = array('label' => t('Width'), 'type' => 'integer');
331
  $info['height'] = array('label' => t('Height'), 'type' => 'integer');
332
  return $info;
333
}