Last modified: August 9, 2022

Overview

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

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

MultiPHP INI Editor

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

Basic Mode

The Basic Mode section of this interface loads the directive values from the php.ini file for the version of PHP that you select. Make your changes to the desired directives and click Save.

The system saves the settings to the /opt/cpanel/<your_php_package>/root/etc/php.ini file, where <your_php_package> represents the name of the PHP package that contains the .ini file that you wish to edit.

• allow_url_fopen  Select whether PHP scripts can use URL-aware fopen wrappers. This setting defaults to Enabled.
• allow_url_include  Select whether PHP scripts can use URL-aware fopen wrappers with the following functions:
  • include()
  • include_once()
  • require()
  • require_once() This setting defaults to Disabled.
• asp_tags  Select whether PHP scripts can use ASP-like tags in addition to PHP tags. This setting defaults to Disabled.
  Note:

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

• display_errors  Select whether PHP displays errors as output or hides them from the user. This setting defaults to Disabled.
• enable_dl  Select whether scripts can call the dl function. This function dynamically loads a PHP extension at runtime. This setting defaults to Disabled.
  Warning:

  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.
• file_uploads  Select whether your PHP scripts can upload HTTP files. This setting defaults to Disabled.
• magic_quotes_gpc  Select whether PHP automatically escapes certain characters with a backslash (\). This setting defaults to Disabled.
• 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. This setting defaults to 30.
• max_input_time  Enter the maximum amount of time, in seconds, that your server allows a script to parse input data. This setting defaults to -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. This setting defaults to 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 adjusts this setting at the time of install, based on system memory:
  • 1 GB  32M
  • 2 - 4GB  64M
  • Over 4 GB  128M
    Note:

    Use the character M to define the limit in megabytes.
• 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. This setting defaults to 8M.
  Note:

  • We strongly recommend that you set this value larger than the upload_max_filesize value and smaller than the memory_limit value.
  • Use the character M to define the limit in megabytes.
• register_globals  Select whether GET or POST input converts into variables that the script can use. This setting defaults to 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. This setting defaults to Disabled.
• session.save_path  Enter the directory in which your server stores the files that PHP creates. This setting defaults to NULL.
  Important:

  • The system saves PHP sessions in the /var/cpanel/php/sessions directory by default. EasyApache 4 installations create subdirectories based on the version of PHP that exists on the server. If multiple versions of PHP exist on the system, a subdirectory exists for each version of PHP. The root user owns each directory, and each directory possesses 1733 permissions. This allows PHP to write session files, but users will not possess permissions to delete those sessions in the directory. Because PHP writes setting files, PHP cannot clean its own sessions. Therefore, the root user must run a cron job to delete the expired session files.
  • Do not change the session.save_path setting to the /tmp directory or a directory that other users or programs use. If you change the session.save_path settings value to another directory, the system will change the directorys permissions to 1733. This will likely break other programs functionality. If you must use the /tmp directory, create a subdirectory under the /tmp directory in which the system will save the PHP session files.
  Note:

  If you change the session.save_path setting in the php.ini configuration file, the cron job will continue to clean up the sessions files in the specified directory. When the system runs the cron job, it will ensure that the configuration file possesses the correct directory permissions.
• session.gc_maxlifetime  Enter the maximum amount of time, in seconds, for the lifetime of a session file. If a session lasts longer than the session.max_lifetime, the system marks it for deletion the next time that it performs a session cleanup. Each version of PHP that you install on the system uses this setting. This setting defaults to 1440 seconds (24 minutes).
  Note:

  Session files can exist on the filesystem for longer than the session.max_lifetime setting. Because session cleanup occurs every 30 minutes, a session file could exist for up to its session.max_lifetime value plus 30 minutes.
• session.gc_probability  Because a cron job cleans up the session files, the system does not require this setting. If you enable this setting, PHP will attempt to delete expired files, which will fail. This setting defaults to 0.
• session.gc_divisor  Because a cron job cleans up the session files, the system does not require this setting. If you enable this setting, PHP will attempt to delete expired files, which will fail. This setting defaults to 0.
• upload_max_filesize  Enter the maximum file size for an upload, in bytes.This setting defaults to 2M.
  Note:

  Use the character M to define the limit in megabytes.
• zlib.output_compression  Select whether to transparently compress pages when the browser sends an Accept-Encoding: gzip or deflate header. This setting defaults to Disabled.

Editor Mode

The Editor Mode section of this interface loads the contents of the php.ini file for your selected version of PHP. Make your changes to the desired directives and click Save.

The system saves the settings to the /opt/cpanel/<your_php_package>/root/etc/php.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 follow the proper format. This does not guarantee that your PHP installation will function. To reset your PHP settings to default values, delete the PHP versions php.ini file.