Guide to Modifying Nginx Configuration for Increasing File Upload Size Limit

Overview of Nginx Configuration Modification

Nginx is a high-performance web server commonly used for serving static content and acting as a reverse proxy. In practical applications, users often need to upload files, but the default file size limit may be insufficient. By modifying the client_max_body_size directive in the nginx.conf file, you can adjust the maximum allowable file upload size. This guide walks you through the configuration process step by step.

Editing nginx.conf with vi Editor

First, connect to your server via an SSH tool like Putty and open the nginx.conf file using the following command:

vi /etc/nginx/nginx.conf

The vi editor is a standard text editor in Linux systems. Once in edit mode, navigate to the appropriate location to make changes. After editing, press the Esc key to exit edit mode, type :wq, and press Enter to save and exit.

Adding the client_max_body_size Directive

The client_max_body_size directive sets the maximum size of the client request body, directly impacting file upload limits. Depending on your server setup, this directive can be placed in two different contexts:

• HTTP Context: Suitable for global settings affecting all server blocks. Add it within the http block:

  http {
      client_max_body_size 8M;
      // other configuration lines...
  }

  This approach is ideal for hosting multiple sites, ensuring a uniform upload limit.
• Server Block: Applicable to specific virtual hosts or sites. Add it within a server block:

  server {
      client_max_body_size 8M;
      // other configuration lines...
  }

  If your server hosts only one site or requires different limits per site, this method is recommended.

In the examples, 8M denotes 8 megabytes; adjust this value as needed, such as 20M or 100M. Ensure correct syntax to avoid errors.

Additional PHP Configuration Adjustments

If your application uses PHP for file uploads, modifying only Nginx may not suffice. You should also adjust the upload_max_filesize directive in the php.ini file. For instance, set it to match the Nginx value:

upload_max_filesize = 8M

This ensures PHP can handle files of the same size. After making changes, restart the PHP service to apply them.

Restarting Services to Apply Configuration

After modifying the configuration files, you must restart Nginx and PHP services for the new settings to take effect. Use the following commands:

sudo service nginx restart
sudo service php5-fpm restart

If your PHP service has a different name (e.g., php-fpm or php7.4-fpm), adjust the command accordingly. After restarting, check the service status to ensure no errors:

sudo service nginx status
sudo service php5-fpm status

If issues arise, consult log files (e.g., /var/log/nginx/error.log) for troubleshooting.

Verifying Configuration Effectiveness

To confirm the modifications are successful, test by uploading a file slightly below the new limit. For example, if set to 8M, try uploading a 7MB file. If successful, the configuration is active. Additionally, use browser developer tools or command-line utilities to check HTTP response headers for any size-related errors.

In summary, by properly editing nginx.conf and adjusting related PHP settings, you can effectively increase file upload size limits and enhance application functionality. Always back up the original configuration file before making changes to prevent unintended issues.