1.20.x file.inc file_transfer($uri, $headers)

Transfers a file to the client using HTTP.

Pipes a file through Backdrop to the client.

Parameters

$uri: String specifying the file URI to transfer.

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

Related topics

File

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

Code

function file_transfer($uri, $headers) {
  if (ob_get_level()) {
    ob_end_clean();
  }

  foreach ($headers as $name => $value) {
    backdrop_add_http_header($name, $value);
  }
  backdrop_send_headers();
  $scheme = file_uri_scheme($uri);
  // Transfer file in 1024 byte chunks to save memory usage.
  if ($scheme && file_stream_wrapper_valid_scheme($scheme) && $fd = fopen($uri, 'rb')) {
    while (!feof($fd)) {
      print fread($fd, 1024);
    }
    fclose($fd);
  }
  else {
    backdrop_not_found();
  }
  backdrop_exit();
}