How to change the PHP upload path when using PHP-FPM

Introduction

PHP uses a system variable to determine the upload path. By default, this is configured as /tmp. The standard workflow uploads a file to /tmp and then moves it into the site's upload path. This article provides the procedure to change the default upload path when your site uses the PHP-FPM PHP handler.

Procedure

1. Access the server's command line as the 'root' user via SSH or "Terminal" in WHM.
2. Open the /var/cpanel/userdata/$cpuser/domain.tld.php-fpm.yaml file in your preferred text editor.
   Please note that "$cpuser" and "domain.tld" must be replaced with the cPanel username and the domain to change the upload location.
3. Add the following line to the file on a new line after the _is_present: 1 line.

   php_admin_value_upload_tmp_dir: { name: 'php_admin_value[upload_tmp_dir]', value: "/path/to/new/upload/folder" }

   Please note that "/path/to/new/upload/folder" must be replaced with the full path to the new upload folder.
4. Save the changes and exit the text editor.
5. Rebuild the PHP-FPM configuration.

   /scripts/php_fpm_config --rebuild

Additional resources

PHP-FPM Configuration Values

How to change the PHP upload path