Search for another article…

How To Configure PHP Using .user.ini


You can use a .user.ini file with your PHP application to configure PHP settings such as the amount of data that can be uploaded, displaying verbose errors, increasing memory limits, and many other configurations. A .user.ini file needs to be in the root of the application or website with the settings configured you wish to change.

This article covers several steps for configuring your PHP environment using .user.ini. The steps are:

  1. Create a .user.ini file
  2. Memory Limit
  3. Max Upload Size
  4. Max Execution Time
  5. Max Input Time
  6. Max Post Size

Creating the file

  1. Create a .user.ini file including the first period. Add the settings you want to change to the file using the same syntax as a php.ini.

  2. Upload it to the root of your application or website. This is commonly the /site/wwwroot/ directory.

  3. Restart your CloudSite from the control panel. This forces the CloudSite to pull the new settings.

PHP Error Debugging

   ; Example Settings
    error_reporting = E_ALL & ~E_DEPRECATED
    display_errors = On
    display_startup_errors = On

Memory Limit

This sets the maximum amount of memory in bytes that a script is allowed to allocate. This helps prevent poorly written scripts for eating up all available memory on a CloudSite.

memory_limit = 256M

Max Upload Size

The maximum size of an uploaded file, this may required if you want to upload larger images or attachments.

upload_max_filesize = 50M

Max Execution Time

This sets the maximum time in seconds a script is allowed to run before it is terminated by the parser.


Max Input Time

This sets the maximum time in seconds a script is allowed to parse input data, like POST and GET.


Max Post Size

Sets max size of post data allowed. This setting also affects file upload. To upload large files, this value must be larger than upload_max_filesize.


Tip: You can create a PHP info page to view your current PHP values. We provide a guide on how to do that included here.

comments powered by Disqus