Jump to content

Manual:$wgMaxUploadSize

From mediawiki.org
Files and file uploads: $wgMaxUploadSize
Maximum size of uploaded files (in bytes)
Introduced in version:1.8.0 (r16159)
Removed in version:Still in use
Allowed values:(integer or array) (see below)
Default value:1024*1024*100 (100MB)

Details

This setting allows you to place a maximum size on each file that can be uploaded to your wiki.

The value(s) you specify refer to the maximum size, in bytes, of a single file upload (not the total of all uploaded files). The limit is applied at the time of upload, so lowering this value at a later date won't remove existing files that are now 'too large'. This limit only applies to chunked uploads and uploads without separate chunks might have a lower upload limit based on the PHP setting.

There are 1024 bytes in a kilobyte, and 1024 kilobytes in a megabyte, so 1024 * 1024 * 100 = 100 megabytes.

The limits for file uploads are controlled by PHP configuration directives. To change the limits for file uploads, you need to modify php.ini, see upload_max_filesize and post_max_size PHP configuration options as well as Manual:Configuring file uploads for details. Note that whichever one of these php.ini variables is smallest will be the limiter. By default, PHP does not allow uploaded files to be more than 2 megabytes.

Specifying an integer

This limits the maximum size of uploaded files, in bytes, regardless of how they are uploaded.

$wgMaxUploadSize = 20000000;

Specifying an array

If you would like different maximum sizes for file uploads and upload-by-URL, you can set this variable to an array. For example:

$wgMaxUploadSize = [
    '*' => 250 * 1024, // 250 KB
    'url' => 500 * 1024, // 500 KB
];

This example will set the maximum for all uploads to 250 KB, except for upload-by-URL, which will have a maximum of 500 KB.

To enable upload-by-URL, see $wgAllowCopyUploads .

MediaWiki version:
1.17
This option has no effect on the normal upload feature for MediaWiki 1.17 and lower! If you've enabled $wgAllowCopyUploads , this setting does limit the size of files copied from a remote URL as expected. When uploading files from your local machine, this setting has no effect (for at least versions 1.9.3 through 1.12).

See also