Jump to content

Manual:$wgUploadPath

From mediawiki.org
Server URLs and file paths: $wgUploadPath
The path segment of the upload directory.
Introduced in version:Before 1.1.0
Removed in version:Still in use
Allowed values:(path)
Default value:"{$wgScriptPath }/images" (1.8+)
"{$wgScriptPath }/upload" (pre-1.1 - 1.7)
(Note: The default value of this variable depends on other variables, such as the values set in Setup.php , after LocalSettings.php is executed)

Details

The relative path to the upload directory. This is used to construct the URLs for viewing uploaded files.

In most cases this is just the path component, such as "/w/images". If uploaded files are served from a different domain, this can be a fully-qualified URL with hostname, such as "http://upload.wikimedia.org/wikipedia/en".

If the variable contains a local path (without "http://") then it must start with a slash, otherwise it will result in a bad URL. (For example if you set it to "foldername" it will result in files being loaded from "http://www.example.comfoldername" - note the missing slash after ".com")

$wgEnableUploads is false by default. Also remember to set directory permissions.

To enable permission checks on image files, $wgUploadPath can be pointed to the img_auth.php script ($wgUploadPath = "$wgScriptPath/img_auth.php";) - see Manual:Image authorization for instructions.

There are other variables which are defined relative to this one. If you redefine this in your LocalSettings.php then all dependent variables including $wgUploadDirectory will need redefining also. If both these settings are not coherent the files will be uploaded to a different folder ($wgUploadDirectory) than from where MediaWiki will try to retrieve them for viewing ($wgUploadPath)!
If using $wgUseInstantCommons or $wgForeignFileRepos with file caching enabled, cached foreign files will be served from $wgUploadPath

See also