1. cPanel & WHM Documentation
  2. cPanel
  3. Software
  4. MultiPHP INI Editor for cPanel
cpanelui php

MultiPHP INI Editor for cPanel

Valid for versions 82 through the latest version

Version:

82

Last modified: 2025 March 11

Looking for this interface?
Note:

Your hosting provider can enable or disable this interface in WHM's Feature Manager interface (WHM >> Home >> Packages >> Feature Manager).

Overview

This interface allows you to configure file directives for a PHP version. These directives control how that version of PHP behaves - for example, whether it limits scripts’ abilities to access or execute local files. You can configure basic directives in the Basic Mode tab of this interface, or add new directives in the Editor Mode tab.

Note:

WHM users can view information about the server’s PHP INI settings in WHM’s MultiPHP INI Editor interface (WHM » Home » Software » MultiPHP INI Editor).

MultiPHP INI Editor

This editor has two tabs:

  • Basic Mode - This tab loads directive values from the php.ini file for your selected domain or entire account.
  • Editor Mode - This tab opens a text editor where you can directly edit the php.ini file for your selected domain or entire account.

Basic Mode

To use the Basic Mode section of this interface, first select the php.ini file you want to configure from the Configure PHP INI basic settings menu. The menu displays a list of each available domain name, along with the account’s Home Directory. To apply changes to all websites you manage, select Home Directory. To apply changes to a specific domain, select its domain name. Your PHP directives will appear.

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.

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 if those files 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.

Editor Mode

To use the Editor Mode section of this interface, first select the php.ini file you want to configure from the Edit PHP INI settings menu. The menu displays a list of each available domain’s domain name, along with the account’s Home Directory. To apply changes to all websites you manage, select Home Directory. To apply changes to a specific domain, select that domain’s domain name. Your PHP directives will appear. If the php.ini file does not exist, the interface loads a blank editor so that you can create your own file.

Warning:
  • 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.
  • You cannot use any of the following words as directives: null, yes, no, true, false, on, off, and none. Directives also cannot contain any of the following special characters: ?, {}, |, &, ~, !,[, (),^, or ".
  • 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.

Make your changes to the desired directives and click Save.

The system saves changes to the php.ini file in the Path section of the interface, the .user.ini file, and the .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.

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.

For more information about a directive, search the php.net documentation.

The DSO PHP handler and PHP major versions

Note:

cPanel & WHM does not support the DSO PHP handler with PHP 8.0 and higher.

If your server administrator enables 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, the system will not read your configuration changes. 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.

The LSAPI module and the htaccess file

If your server administrator includes the LSAPI module in your PHP configuration, the system also adds an LSAPI section to your .htaccess file. This section might resemble the following example: 

1
2
3
4
5

<IfModule lsapi_module>
      php_value date.timezone "America/Chicago"
      php_value memory_limit 128M
      php_value upload_max_filesize 60M
</IfModule>

Additional Documentation