file_create_url

5 file.inc	`file_create_url($path)`
6 file.inc	`file_create_url($path)`
7 file.inc	`file_create_url($uri)`
8 file.inc	`file_create_url($uri)`

Create the download path to a file.

Parameters

$path A string containing the path of the file to generate URL for.:

Return value

A string containing a URL that can be used to download the file.

▸ 5 functions call file_create_url()

▾ 5 functions call file_create_url()

blogapi_metaweblog_new_media_object in modules/blogapi/blogapi.module: Blogging API callback. Inserts a file into Drupal.
template_preprocess_user_picture in modules/user/user.module: Process variables for user-picture.tpl.php.
theme_upload_attachments in modules/upload/upload.module: Displays file attachments in table
upload_nodeapi in modules/upload/upload.module: Implementation of hook_nodeapi().
_upload_form in modules/upload/upload.module

File

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

Code

<?php
function file_create_url($path) {
  // Strip file_directory_path from $path. We only include relative paths in urls.
  if (strpos($path, file_directory_path() . '/') === 0) {
    $path = trim(substr($path, strlen(file_directory_path())), '\\/');
  }
  switch (variable_get('file_downloads', FILE_DOWNLOADS_PUBLIC)) {
    case FILE_DOWNLOADS_PUBLIC:
      return $GLOBALS['base_url'] . '/' . file_directory_path() . '/' . str_replace('\\', '/', $path);
    case FILE_DOWNLOADS_PRIVATE:
      return url('system/files/' . $path, array('absolute' => TRUE));
  }
}
?>

Comments

Note that this function

Posted by Garrett Albright on April 27, 2011 at 11:14am

Note that this function behaves very differently in Drupal 7. When it comes time to port to D7, try combining this function with file_build_uri() like this:

<?php
$file_uri = file_create_url(file_build_uri('images/example.jpeg'));
?>