PHP Configuration

The PHP Config panel lets you switch PHP versions and tune php.ini settings for WordPress applications. It is available in the PHP Config tab on any WordPress app's detail page.

Switching PHP Versions

ServerPlane supports PHP 8.1, 8.2, 8.3, and 8.4.

  1. Open your WordPress app's detail page and go to the PHP Config tab.
  2. The current PHP version is displayed at the top. Select a new version from the dropdown.
  3. Click Switch Version.

What happens during a version switch

  1. The selected PHP version is installed on the server if not already present.
  2. Your existing settings are carried over to the new version automatically.
  3. The web server is reconfigured to use the new PHP version.

The switch typically takes 30-60 seconds. If the new version needs to be installed from scratch, it may take a few minutes.

After switching, ServerPlane reloads your php.ini settings and extensions list to reflect the new version.

Editing php.ini Settings

Six commonly tuned settings are exposed in the UI:

Setting Default Description
upload_max_filesize 64M Maximum size of a single uploaded file
post_max_size 64M Maximum size of POST request body (should be >= upload_max_filesize)
memory_limit 256M Maximum memory a PHP process can use
max_execution_time 300 Maximum script execution time in seconds
max_input_time 300 Maximum time to parse input data in seconds
max_input_vars 3000 Maximum number of input variables (useful for complex forms, WooCommerce)

How to change settings

  1. In the PHP Config tab, update the values in the form fields.
  2. Click Save Configuration.
  3. PHP is automatically restarted. Changes take effect immediately.

Value formats

  • Memory/size values accept suffixes: M (megabytes), G (gigabytes), K (kilobytes). Example: 128M, 1G.
  • Time and count values are plain integers. Example: 300, 5000.

PHP Extensions

The PHP Config tab also shows all installed and available PHP extensions for the current version.

Managing extensions

  1. In the PHP Extensions section, you will see two lists: currently enabled extensions and available extensions.
  2. Click an available extension to stage it for installation. Click an enabled extension's remove button to stage it for removal.
  3. Core extensions (e.g., common, json, openssl, session) cannot be disabled.
  4. Once you have staged your changes, a "Pending Changes" banner appears. Click Apply Changes to install/remove all staged extensions at once.
  5. PHP is automatically restarted after applying changes.

Version Detection

When the PHP Config tab loads, ServerPlane checks the actual PHP version running on the server for your app. If it differs from what is stored (for example, after a manual change on the server), it is automatically corrected and a warning is shown.

Notes

  • PHP configuration is only available for WordPress apps. Node.js, Python, Docker, and static site apps do not have this tab.
  • Settings applied through this panel take priority and cannot be overridden by .htaccess or ini_set() in application code.
  • For settings not exposed in the UI, you can make changes via the web terminal or SFTP.