(cPanel >> Home >> Software >> MultiPHP INI Editor)
Overview
This interface allows you to configure your PHP settings.
MultiPHP INI Editor
Select the location that you wish to configure from the menu. You can edit either the account's home directory or the domain's document root. The PHP directives will appear.
Basic Mode
The Basic Mode section of this interface loads directive values from the php.ini file for your selected domain or home directory. Make your changes to the desired directives and click Apply. The system saves changes to the php.ini file, the user.ini file, and your .htaccess file.
- For security purposes, we strongly recommend that you use the cPanel-provided default values.
- The availability of directives depends on your version of PHP. If a directive does not appear in your interface, your version of PHP does not support it.
-
The system only writes a directive to an .ini or .htaccess file if that file supports the directive. Your php.ini, .user.ini, and .htaccess files may not be identical. For more information about which files support which directives, read PHP's documentation.
- To ensure compatibility with the LSAPI module, the system also adds an LSAPI section to your .htaccess file. This section might resemble the following example:
<IfModule lsapi_module>
php_value date.timezone "America/Chicago"
php_value memory_limit 128M
php_value upload_max_filesize 60M
</IfModule>
If you use the DSO PHP handler and you change your PHP version to a different major PHP version, the system will not read your configuration changes. For example, if you change your PHP version from PHP 5 to PHP 7.
To correct this issue, you must edit and save your PHP configuration again in the interface. The system will then load the .htaccess directives correctly.
PHP Directive | Description | cPanel Default | PHP Default |
allow_url_fopen |
Select whether PHP scripts can use URL-aware fopen wrappers. The system only displays this directive if you use the suPHP PHP handler. |
Disabled | Enabled |
allow_url_include |
Select whether PHP scripts can use URL-aware fopen wrappers with the following functions:
The system only displays this directive if you use the suPHP PHP handler. |
Disabled | Disabled |
asp_tags |
Select whether PHP scripts can use ASP-like tags in addition to PHP tags. This includes variable-value printing shorthand (for example, <%= $value %>). |
Disabled | Disabled |
display_errors | Select whether PHP displays errors as output or hides them from the user. | Disabled | Enabled |
enable_dl |
Select whether scripts can call the dl function. This function dynamically loads a PHP extension at runtime. If you set this directive to Enabled, it poses security risks to your server. We strongly recommend that you select Disabled unless you absolutely require the dl function. The system only displays this directive if you use the suPHP PHP handler. |
Disabled | Enabled |
file_uploads |
Select whether your PHP scripts can upload HTTP files.
|
Enabled | Enabled |
magic_quotes_gpc | Select whether PHP automatically escapes certain characters with a backslash (\). | Enabled | Enabled |
max_execution_time | Enter the maximum amount of time, in seconds, that your server allows a script to run before your server terminates it. This setting limits the amount of memory that poorly-written scripts may use. | 30 | 30 |
max_input_time | Enter the maximum amount of time, in seconds, that your server allows a script to parse input data. | 60 | -1 |
max_input_vars | Enter the maximum number of input variables per request. Use this directive to deter Denial of Service (DoS) attacks that use hash collisions on input variable names. | 1000 | 1000 |
memory_limit |
Enter the maximum amount of memory that scripts can allocate, in bytes. This setting helps to prevent poorly-written scripts that may use too much memory. cPanel & WHM sets the default value based on the system's memory at the time of install. Use the character M to define the limit in Megabytes. |
cPanel & WHM adjusts this setting at the time of install, based on system memory:
|
128M |
post_max_size |
Enter the maximum size of post data that the system allows, in bytes. This setting affects file uploads. Set this value to 0 to allow unlimited post sizes.
|
8M | 8M |
register_globals | Select whether GET or POST input converts into variables that the script can use. | Disabled |
Disabled |
safe_mode |
Select whether to enable safe mode. Safe mode increases security for PHP scripts and enables user, group, and environment checks and controls. The system only displays this directive if you use the suPHP PHP handler. |
Disabled |
Disabled |
session.save_path | Enter the directory in which your server stores the files that PHP creates. | NULL | NULL |
upload_max_filesize |
Enter the maximum file size for an upload, in bytes. Use the character M to define the limit in Megabytes. |
2M | 2M |
zlib.output_compression | Select whether to transparently compress pages when the browser sends an Accept-Encoding: gzip or deflate header. | Disabled |
Disabled |
Editor Mode
Select the location that you wish to configure from the menu. You can edit either the user account's home directory or the domain's document root. The PHP directives will appear.
- You must exercise extreme caution when you make changes in this interface. Errors could result in non-functional PHP scripts. Only advanced users should use this interface.
- We restrict the following words and you cannot use them as directives: null, yes, no, true, false, on, off, and none. Directives also cannot contain any the following special characters: ?{}|&~![()^"
- The following values set the directive value to "": null, off, no, and false.
- The following values set the directive value to 1: on, yes, and true.
The Editor Mode section of this interface loads the contents of the php.ini file for your selected domain, if it exists. If the php.ini file does not exist, the interface loads a blank editor so that you can create your own file. Make your changes to the desired directives and click Save.
The system saves changes to both the php.ini file in the Path section of the interface and the .user.ini file. The system also saves these changes to your .htaccess file.
To ensure compatibility with the LSAPI module, the system also adds an LSAPI section to your .htaccess file. This section might resemble the following example:
<IfModule lsapi_module>
php_value date.timezone "America/Chicago"
php_value memory_limit 128M
php_value upload_max_filesize 60M
</IfModule>
For example, the location of your file may be the /home/allthethings/public_html/php.ini file. The interface attempts a rudimentary validation of directive names. This does not guarantee that your PHP configuration will function. To reset your PHP settings to default values, delete the domain's or home directory's php.ini file.
The system only writes a directive to an .ini or .htaccess file if that file supports the directive. Your php.ini, .user.ini, and .htaccess files may not be identical. For more information about which files support which directives, read the PHP documentation.
If you use the DSO PHP handler, the system will not read your configuration changes if you change your PHP version to a different major PHP version. For example, you change your PHP version from PHP 5 to PHP 7.
To correct this issue, you must edit and save your PHP configuration again in the interface. The system will then load the .htaccess directives correctly.
For more information about a directive, search the php.net documentation.