Configure PHP

Configure PHP by Version 

These changes are recorded in each PHP versions php.ini which resides at the following filepath, replacing {php.version} with the version of PHP required:

/etc/php/{php.version}/fpm/php.ini

Settings configured in aphp.iniare global by nature and impact each WordPress site which uses that particular version of PHP, unless that site has a conflicting per site .user.ini setting, in which case the per-site configuration takes precedence.

In each command below, substitute your PHP version (7.2, 7.3, etc) in place of {php.version}.

Each command automatically reloads the requisite PHP version, however, if you are wishing to chain together several commands you may wish to use the -no-reload flag as the last argument. This will stop you from reloading PHP multiple times, after which you can reload php.

For example:

gp stack php 7.4 -mem-limit 512 -no-reload &&  
gp stack php 7.4 -max-exec-time 60 -no-reload && 
gp php 7.4 reload

back to top ▲

PHP Version General Settings

These commands all take integer arguments, with the integer being converted into the required unit by the script. and impact all WordPress sites using that version of PHP.

▲

ALLOW URL-AWARE FOPEN WRAPPERS.

Enable URL-aware fopen wrappers that enable accessing URL objects like files.

Directive: allow_url_fopen
Default value: on
Accepted values: Boolean/on/off/On/Off/ON/OFF

gp stack php {php.version} -allow-url-fopen {accepted.value}

Example:

gp stack php 7.4 -allow-url-fopen on

Optional last flag: -no-reload

This directive can only be set at the PHP version level.

back to top ▲

▲

ALLOW URL-AWARE FOPEN WRAPPERS WITH INCLUDE FUNCTIONS.

Allows the use of URL-aware fopen wrappers with the following functions:

include, include_once, require, require_once

Directive: allow_url_include
Default value: off
Accepted values: Boolean/on/off/On/Off/ON/OFF
Requires: allow_url_fopen = on

gp stack php {php.version} -allow-url-include {accepted.value}

Example:

gp stack php 7.4 -allow-url-include on

Optional last flag: -no-reload

This directive can only be set at the PHP version level.

back to top ▲

▲

SET THE DEFAULT TIMEZONE USED BY ALL DATE/TIME FUNCTIONS.

Sets The default timezone used by all date/time functions. The precedence order for which timezone is used if none is explicitly mentioned is described in the date_default_timezone_get() page at php.net. Please check this list of supported timezones at php.net.

Directive: date.timezone
Default value: NULL
Accepted Values: {supported.timezone} (String)

gp stack php {php.version} -date-timezone {supported.timezone}

Example:

gp stack php 7.4 -date-timezone Pacific/Honolulu

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE SOCKET/STREAM WAIT TIMEOUT FOR A PHP SCRIPT.

The socket/stream wait time is not included in PHPs max execution time. The default socket timeout in PHP is 60 seconds. HTTP requests performed with some functions may exceed the execution time due to this wait being too short. Examples of such functions include:

file_get_contents, fopen or curl

Directive: default_socket_timeout
Unit: Seconds
Default value: 60

gp stack php {php.version} -default-socket-timeout {integer}

Example:

gp stack php 7.4 -default-socket-timeout 300

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE MAXIMUM EXECUTION TIME FOR EACH PHP SCRIPT.

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

Directive: max_execution_time
Unit: Seconds
Default value: 300

gp stack php {php.version} -max-exec-time {integer}

Example:

gp stack php 7.4 -max-exec-time 300

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE MAXIMUM NUMBER OF FILES THAT CAN BE UPLOAD VIA A SINGLE REQUEST BY A PHP SCRIPT.

The maximum number of files allowed to be uploaded simultaneously. Upload fields left blank on submission do not count towards this limit.

Directive: max_files_upload
Unit: Files
Default value: 20

gp stack php {php.version} -max-file-uploads {integer}

Example:

gp stack php 7.4 -max-file-uploads 1024

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE MAXIMUM INPUT TIME FOR EACH PHP SCRIPT.

Set the maximum time in seconds a script is allowed to parse input data, like POST and GET. Timing begins at the moment PHP is invoked at the server and ends when execution begins. Set to 0 to allow unlimited time.

Directive: max_input_time
Unit: Seconds
Default value: 60

gp stack php {php.version} -max-input-time {integer}

Example:

gp stack php 7.4 -max-input-time 120

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET HOW MANY GET/POST/COOKIE INPUT VARIABLES MAY BE ACCEPTED BY A PHP SCRIPT.

How many input variables may be accepted (limit is applied to $_GET, $_POST and $_COOKIE superglobal separately). Use of this directive mitigates the possibility of denial of service attacks that use hash collisions.

Directive: max_input_vars
Unit: Variables
Default value: 5000

gp stack php {php.version} -max-input-vars {integer}

Example:

gp stack php 7.4 -max-input-vars 10000

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE MAXIMUM POST SIZE PER PHP SCRIPT.

Sets max size of post data allowed.  To upload large files, this value must be larger than upload_max_filesize.  Generally speaking, this should also be smaller than the set memory_limit.

Directive: post_max_size
Unit: MB
Default value: 512

gp stack php {php.version} -post-max-size {integer}

Example:

gp stack php 7.4 -post-max-size 1024

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE MEMORY LIMIT FOR EACH PHP SCRIPT

Set the maximum amount of memory that a script is allowed to allocate. This helps prevent poorly written scripts for eating up all available memory on a server. Note that to have no memory limit, set this directive to -1.

Directive: memory_limit
Unit: MB
Default value: 256

gp stack php {php.version} -mem-limit {integer}

Example:

gp stack php 7.4 -mem-limit 512

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE SESSION COOKIE LIFETIME FOR A COOKIE CREATED BY A PHP SCRIPT.

Specify the lifetime of a cookie in seconds which is sent to the browser. The value 0 means “until the browser is closed.”

Directive: session.cookie_lifetime
Unit: Seconds
Default value: 0

gp stack php {php.version} -session-cookie-lifetime {integer}

Example:

gp stack php 7.4 -session-cookie-lifetime 3600

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲

▲

SET THE GARBAGE COLLECTION FOR DATA CREATED BY A PHP SCRIPT.

Specify the number of seconds after which data will be seen as ‘garbage’ and potentially cleaned up.

Directive: session.gc_maxlifetime
Unit: Seconds
Default value: 1440

gp stack php {php.version} -session-gc-maxlifetime {integer}

Example:

gp stack php 7.4 -session-gc-maxlifetime 3600

Optional last flag: -no-reload

This directive may also be set on a per-site level. Any per-site configuration will supersede this configuration.

back to top ▲