Same name and namespace in other branches
  1. 4.7.x includes/file.inc \file_transfer()
  2. 5.x includes/file.inc \file_transfer()
  3. 6.x includes/file.inc \file_transfer()
  4. 7.x includes/file.inc \file_transfer()

Transfer file using http to client. Pipes a file through Drupal to the client.

Parameters

$source File to transfer.:

$headers An array of http headers to send along with file.:

Related topics

1 call to file_transfer()
upload_download in modules/upload.module

File

includes/file.inc, line 456
API for handling file uploads and server file management.

Code

function file_transfer($source, $headers) {
  ob_end_clean();
  foreach ($headers as $header) {

    // To prevent HTTP header injection, we delete new lines that are
    // not followed by a space or a tab.
    // See http://www.w3.org/Protocols/rfc2616/rfc2616-sec4.html#sec4.2
    $header = preg_replace('/\\r?\\n(?!\\t| )/', '', $header);
    header($header);
  }
  $source = file_create_path($source);

  // Transfer file in 1024 byte chunks to save memory usage.
  if ($fd = fopen($source, 'rb')) {
    while (!feof($fd)) {
      print fread($fd, 1024);
    }
    fclose($fd);
  }
  else {
    drupal_not_found();
  }
  exit;
}