Forcer le téléchargement d'un fichier sous Drupal 7

Nouveau billet rapide pour vous partager une fonctionnalité.

Pour forcer le téléchargement d'un fichier, comme d'habitude avec Drupal, il y a un module pour ça. Dans ce cas précis il y en a même deux : Download file et File force. Mais bon comme d'habitude, la flemme d'installer un module pour une si petite fonctionnalité ! Alors voici la solution en quelques lignes de code :

Voici un bout de code se basant sur la File API. Il est plus sécurisé par rapport au deuxième mais ne fonctionnera que pour les fichiers gérés par Drupal (quelque soit la méthode de téléchargement) : je le recommande donc.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<?php
/**
 * Implementation of hook_menu()
 */
function mymodule_menu() {
  $items['download/%file'] = array(
    'page callback' => 'mymodule_download_file',
    'access arguments' => array('administer site configuration'),
    'type' => MENU_CALLBACK,
  );
  return $items;
}
 
/**
 * Page callback for forcing a file to download
 */
function mymodule_download_file($file) {
  if($file) {
    file_transfer($file->uri, array('Content-disposition' => 'attachment; filename='.$file->filename));
  }
  else {
    return drupal_access_denied();
  }
}

Il suffira d'appeler le fichier sous la forme http://mysite.com/download/123 où 123 est l'identifiant fid du fichier à télécharger.

Ce deuxième bout de code présente un danger pour la sécurité ! Il est recommandé de l'utiliser en dernier recours lorsque les fichiers ne sont pas gérés par Drupal. Pour accroître la sécurité on proposera cette fonctionnalité seulement aux administrateurs, et on filtrera les extensions autorisées au téléchargement.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<?php
/**
 * Implementation of hook_menu()
 */
function mymodule_menu() {
  $items['download'] = array(
    'page callback' => 'mymodule_download_file',
    'access arguments' => array('administer site configuration'),
    'type' => MENU_CALLBACK,
  );
  return $items;
}
 
/**
 * Page callback for forcing a file to download
 */
function mymodule_download_file() {
  if (!isset($_GET['file']) || !file_exists($_GET['file'])) {
    return drupal_not_found();
  }
  $filepath = $_GET['file'];
  $realpath = realpath($path);
  $filename = basename($filepath);
  $extension = pathinfo($filepath, PATHINFO_EXTENSION);
  // Vérification de l'extension et restriction aux fichiers dans DRUPAL_ROOT
  if(in_array($extension, array('jpg', 'png', 'gif', 'mp4')) && substr($path, 0, strlen(DRUPAL_ROOT)) === DRUPAL_ROOT) {
    drupal_add_http_header('Content-disposition', 'attachment; filename=' . $filename);
    readfile($filepath);
  }
  else {
    return drupal_access_denied();
  }
}

Il vous suffira ensuite de créer votre lien sous la forme http://mysite.com/download?file=sites/default/files/monimage.png

Ceci ne fonctionne que pour la méthode de téléchargement publique mais c'est la plus répandue.