Page tree
Skip to end of metadata
Go to start of metadata

For cPanel & WHM version 11.52

(Home >> Software >> MultiPHP INI Editor)

Important:

WHM's MultiPHP INI Editor interface only exists on systems that run EasyApache 4.  

Overview

This interface allows you to configure your PHP settings. The PHP scripting language generates web pages.

Note:

cPanel users can view information about the server's PHP configuration in cPanel’s MultiPHP INI Editor interface (Home >> Software >> MultiPHP INI Editor).

MultiPHP INI Editor

Select a tab to view more information about that section of the  MultiPHP INI Editor  interface. 

Select the PHP version that you wish to configure from the menu. The PHP directives will appear.

The Basic Mode section of this interface loads the directive values from the local.ini file for your selected version of PHP, if it exists. Otherwise, this interface loads the directive values from the php.ini file of your selected version of PHP. Make your changes to the desired directives and click Save.

Changes save to the /opt/cpanel/<your_php_package>/root/etc/php.d/local.ini file, where <your_php_package> represents the name of the PHP package that contains the .ini file that you wish to edit.

Notes:

  • The availability of the following 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 listed default values mirror those on the php.net website.
PHP directiveDescriptionPHP default
allow_url_fopen Select whether PHP scripts can use URL-aware fopen wrappers.On
allow_url_include Select whether PHP scripts can use URL-aware fopen wrappers with the following functions: include(), include_once(), require(), and require_once().Off
asp_tags

Select whether PHP scripts can use ASP-like tags in addition to PHP tags.

Note:

This includes variable-value printing shorthand (for example, <%= $value %>).

Off
display_errors Select whether PHP displays errors as output or hides them from the user.Off
enable_dl

Select whether scripts can call the dl function. This function dynamically loads a PHP extension at runtime. 

Warning:

If you set this directive to On, it poses security risks to your server. We strongly recommend that you select Off unless you absolutely require the dl function.

Off
file_uploads Select whether your PHP scripts can upload HTTP files.On
include_path

Enter the paths where PHP functions search for files when a script calls certain functions.

Note:

Separate the directory paths with a colon (:) in a Unix environment, or a semicolon (;) in a Windows® environment.

.;/path/to/php/pear

magic_quotes_gpc

Select whether PHP automatically escapes certain characters with a backslash (\).On
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
max_input_time Enter the maximum amount of time, in seconds, that your server allows a script to parse input data. -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
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. 

Note:

Use the character M to define the limit in Megabytes.

128M

register_globals

Select whether GET or POST inout converts into variables that the script can use.Off

safe_mode

Select whether safe mode is on. Safe mode increases security for PHP scripts and enables user, group, and environment checks and controls.

Off
session.save_path Enter the directory in which your server stores the files that PHP creates.NULL
upload_max_filesize

Enter the maximum file size for an upload, in bytes.

Note:

Use the character M to define the limit in Megabytes.

2M

Select the PHP version that you wish to configure from the menu. The PHP directives will appear.

Warnings:

  • 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 reserve 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 local.ini file for your selected version of PHP, if it exists. Otherwise, this interface loads the php.ini file for your selected version of PHP. Make your changes to the desired directives and click Save.

Changes save to the /opt/cpanel/<your_php_package>/root/etc/php.d/local.ini file, where < your_php_package > represents the name of the PHP package that contains the .ini file that you wish to edit. The interface attempts a rudimentary validation of directive names to ensure that they are properly formatted. This does not guarantee that your PHP will function. To reset your PHP settings to the default, delete the PHP version's local.ini file.

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

Additional documentation

PHP Security Concepts — This document explains some of our recommendations to help you improve PHP's security on your server.

  • No labels