---
title: "Change PHP version"
url: https://docs.corefinity.com/guides/sites/software-and-services/php-version
type: guide
last_updated: 2026-11-13
feature: php-runtime
related:
  - https://docs.corefinity.com/api/reference/runtime/get-php-catalogue.md
  - https://docs.corefinity.com/api/reference/runtime/update-mariadb-version.md
  - https://docs.corefinity.com/api/reference/runtime/get-php-runtime.md
  - https://docs.corefinity.com/api/reference/runtime/copy-php-runtime.md
  - https://docs.corefinity.com/api/reference/runtime/list-php-runtime-history.md
  - https://docs.corefinity.com/api/reference/runtime/get-php-runtime-revision.md
  - https://docs.corefinity.com/mcp/tools/corestack_php_version_change.md
  - https://docs.corefinity.com/mcp/tools/corestack_mariadb_version_change.md
  - https://docs.corefinity.com/mcp/tools/corestack_runtime_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_runtime_adopt.md
  - https://docs.corefinity.com/mcp/tools/corestack_php_runtime_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_php_catalogue_get.md
---
# Change PHP version

Switch a site to another PHP version, and see what else changes before you do.

## Before you start

- You can open the site in **Managed Websites**. Anyone who can open a site can change its PHP version.
- Your code runs on the version you are moving to.
- [Take a backup](/guides/sites/backups/snapshots), to have a way back.

## Change the version

1. **Open Software & services**

   Go to **Managed Websites**, choose the site, then **Software & services** under **Site settings**. Choose **Change…** beside **PHP**.

   _Screenshot: A site page with Software & services open. The Services card lists PHP 8.3 and the database, with the buttons Change… and Configure… beside PHP._

2. **Choose the version**

   Choose a version, such as 8.4. **Before you switch to PHP 8.4** lists anything else that changes, such as an extension that switches off.

   _Screenshot: The Change PHP version dialog with 8.4 chosen from 8.2, 8.3, 8.4 and 8.5. Below, Before you switch to PHP 8.4 reads Nothing changes besides the version, and the button reads Switch to PHP 8.4._

3. **Switch**

   Tick any confirmation the dialog asks for, then choose **Switch to PHP 8.4**. The button names the version you chose.

   _Screenshot: Software & services after the change: PHP on the Services card reads 8.4, marked Supported, and the site header shows 8.4 too._

The change applies now. When it is done, **PHP** under **Services** and the site header show the new version.

> **Tip:** **Change PHP version…** is also in the site header's **…** menu.

## What the labels mean

| Label                   | Meaning                                                                       |
| ----------------------- | ----------------------------------------------------------------------------- |
| **In use**              | The version the site runs now.                                                |
| **Supported**           | A current version, with security fixes until the date shown.                  |
| **Security fixes only** | An older version. Security fixes stop on the date shown.                      |
| **End of life**         | Gets no security fixes. Use it only while you upgrade your code.              |
| **Preview**             | A release candidate for trying your code. It cannot be chosen for production. |

## Automate this

**API:** [Update a site's PHP version](https://docs.corefinity.com/api/reference/runtime/update-php-version.md), scope `write`

```bash
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/php-version \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "acknowledge": [
      "eol"
    ],
    "to": "8.1"
  }'
```

**MCP:** [`corestack_php_version_change`](https://docs.corefinity.com/mcp/tools/corestack_php_version_change.md), scope `write`

```json
{
  "name": "corestack_php_version_change",
  "arguments": {
    "site_id": 4211,
    "to": "8.4"
  }
}
```

**Control Panel:** Managed Websites › your site › Site settings › Software & services ([https://manage.corefinity.com/go/php-runtime](https://manage.corefinity.com/go/php-runtime))

## Related

- [PHP configuration](/guides/sites/software-and-services/php-settings-and-php-ini): Change PHP limits, extensions and php.ini.
- [Backups](/guides/sites/backups/snapshots): Take a backup before a change.
- [Logs](/guides/sites/logs-and-monitoring/logs): Read and narrow a site's logs.
