Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Jon Witts/file-upload-v2.
Probably the most frequently asked question in the Moodle.org Using Moodle forums is "How do I increase the upload file size limit?" Uploading files in Moodle is controlled both externally, within the server environment, and internally by Moodle - this is the nature of the Internet and cannot be avoided. While this page will primarily focus upon making changes in on the server environment, outside of the Moodle interface, it will also look at the changes you can make inside Moodle.
There are different web server operating systems, thus the method of increasing the uploaded file limit can be different in each. Typically this process is controlled directly by PHP, but some web server systems can override php settings.
- 1 Overview
- 2 Php.ini changes
- 3 Find php.ini control information
- 4 What web server are you using?
- 5 How is php running on your web server?
- 6 What access do you have to the server?
- 7 Hosted Server
- 8 See also
File Upload sizes can be restricted in a number of different places. The list below shows the order of inheritance that file upload sizes follow.
- PHP Server level - File upload size (which is this page)
- Moodle site level - Site Policies
- Course level - Course Settings
- Activity level - Adding/Editing a Forum, Upload a Single File Assignment and Advanced Uploading of Files Assignment
As you can see, it is the PHP server level that has the greatest precedence. So to increase the file upload size in Moodle we must first adjust this setting. You will need to find out where the active php.ini is located and if another program is over riding it.
Here are the changes you might make to a php.ini file. For those who need more information, please continue reading other sections in this page.
After find the correct php.ini file, look for and change two variables. In the example below, we found the following lines set the max file size to 512 megabytes.
upload_max_filesize = 512M post_max_size = 512M
This may seem large, but do not forget, the Administrator can go to Front Page ► Administration ► Courses ► Course default settings and reset the maximum file upload size to whatever level required. It also means that if someone needs a maximum file size temporarily, say a multimedia teacher uploading a large file, the Administrator can reset these values in the same location, and set them back again later.
Find php.ini control information
For those who are continuing on and need more information, you may need to find the php.ini file that controls the size of the upload files.
- In PHP 4.x there must be a php.ini file in every directory that has php scripts.
- In PHP 5.x there is only one php.ini file that is active. There maybe many php.ini files on the server, but only one will effect the file upload size. You can find this file by writing a php script or using the Moodle interface.
- Some Application Programming Interface (API) servers will handle php settings differently
Moodle php info
The easiest way to find the location of the controlling php.ini files in Moodle 1.7 onward is to call up Site administration block>Server>PHP info. This will run an information script.
- Server API - shows the server type
- Configuration File (php.ini) Path - show the location of the file.
- Loaded Configuration File (if there)- will over ride the above location.
For Moodles prior to 1.7 or on any server, you can create your own information page. Follow the instruction at phpinfo for more information.
At the very top of the phpinfo page you will see the version of PHP that your server is running.
- Loaded Modules: For example Apache2Handler
What web server are you using?
If you are using an Apache web server you can use .htaccess files to override the php.ini settings, or you can edit the active php.ini files on your server. Look for the API as Apache Handler. After making changes, you will have to restart your server.
Add the below to your .htaccess file
* php_value upload_max_filesize 512M * php_value post_max_size 512M
There seems to be a double whammy for IIS. Not only is there a restriction in file size uploads for PHP there is also one for IIS. To change the PHP limit is the same as is described above, at the start, change those two variables already mentioned. The next issue is with IIS. This comes from Microsoft's knowledge base. Unfortunately, like most Microsoft documentation, it is not all that clear.
MaxRequestEntityAllowed The MaxRequestEntityAllowed property specifies the maximum number of bytes allowed in the entity body of a request. If a Content-Length header is present and specifies an amount of data greater than the value of MaxRequestEntityAllowed, IIS sends a 403 error response. The metabase represents unlimited as the DWORD value of 4294967295 (0xFFFFFFFF); however, VBScript represents unlimited in hexadecimal format as &HFFFFFFFF. Previous versions of IIS represented unlimited as -1.
There is a lot more, but this should provide you with the basic knowledge you need to be able to change the upload file size limits.
To make PHP work a little better in IIS, you can utilize the FastCGI component, information about which can be found in this php.iis.net site.
How is php running on your web server?
PHP can interact with other programs on your web server. If PHP is being controlled by an Apache Handler, you will have to restart your server. The changes will take place immediately if you are running API server using say CGI/FastCGI .
You can find out how your web server is running PHP by looking at:
- Site administration>Server>PHP info "Server API"
- phpinfo page: Apache2Handler > Loaded Modules Section.
What access do you have to the server?
To make changes to the main php.ini file you will need administrative access to the server...
Local / Full access to server
Things can be a little different with a hosted server for uploaded and downloaded file size. You are probably going to to be told to create or change a .htaccess file, or to modify a php.ini file.
- It might be a good idea to talk to with your service provider before you attempt anything. They probably have instructions on "how to" and may have their own limits for uploaded file size. Some hosts measure the file size in gigabytes and others in megabytes. If you are unhappy with their limits, then check your contract and consider changing your provider to one that has a limit and price that you like.
.htaccess with hosted server
The one purpose of an .htaccess file is to override the the current limitations of both the server and the php.ini file. Your hosted server should inform you where that file needs be placed in your Moodle, but generally in the root is sufficient. They should already have a standard file in place or you can copy it from another location.
To the .htaccess file find or add the lines:
php_value upload_max_filesize 128M php_value post_max_size 128M
This will limit uploads to 128MB, but you can make it any size you agree with your provider. The wording may vary slightly, according to the demands of the server.
php.ini with hosted server
Some servers will not allow you to change the moodle root .htaccess file and will tell you to use a php.ini file for php directives. The steps are basically the same as we covered above and your host will probably be running PHP 5.x
- Locate the key php file. It probably will not be located with your Moodle code.
- Using a file edit program, change the upload max and post max size in the active php file.
For example we found the following lines and the max file size is 20 megabytes.
upload_max_filesize = 20M post_max_size = 20M