Update a site's PHP configuration
Changes the extensions, the settings, PHP-FPM, Xdebug or the custom php.ini. Send the version of your last read and only the parts you change: a part you leave out stays as it is. extensions, xdebug and custom_ini replace that part whole. settings and fpm are merged into what the site has: an entry you leave out keeps its value, and null puts one back to its default. Answers 201 with the operation that applies the change, or 200 when nothing differs. When the platform does not confirm the save, the 201 carries an operation that is still pending: follow it, and do not send the change again meanwhile.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Body
When a change that needs a maintenance window is applied. now applies it at once. tonight queues it for the site's next window. window means the same as tonight. An endpoint that takes window only while maintenance windows are on for your company says so, and refuses it 422 on apply otherwise. Defaults to now.
nowtonightwindowThe whole custom php.ini, saved exactly as sent. An empty string removes it.
Every optional extension to load, by name. An empty list turns them all off.
PHP-FPM settings, merged into the ones the site has: a setting you leave out keeps its value, and null puts one back to the platform's value. Each setting has two spellings that mean the same.
Fields
100 to 100000.
dynamicondemandstaticnullThe same as max_requests. 100 to 100000.
The same as process_idle_timeout. Seconds. Only with pm ondemand. 5 to 300.
Seconds. Only with pm ondemand. 5 to 300.
Directives of the settings form and their values, merged into the settings the site has: a directive you leave out keeps its value. Sizes are whole numbers of bytes. Null puts a directive back to its default, except memory_limit, upload_max_filesize and max_execution_time, which always have a value: null for one of those is refused 422 with the code required.
The version of your last read. At least 0.
Xdebug's set-up, or null to turn it off. Refused on production.
Returns
200 Nothing differs from what the site has. operation is null.
201 The change started (operation), or was queued for the site's window (queued).
Fields of the 200 answer
True when the change also moves the site onto the runtime.
The id of the pending change. Sent only with queued. At least 1.
The operation that applies the change. Null when nothing differs and when the change was queued.
A site's PHP configuration.
Fields
True when the site is on the runtime. Extensions, the full settings form, PHP-FPM, Xdebug and the php.ini need it.
Whether a site is on the runtime, and whether it can move onto it.
Fields
Why the site cannot move at once, when it cannot.
True when the site is on the runtime.
The date Corefinity plans to move the site, if one is set.
The date of the window the move is queued for, if it is queued.
The runtime revision the site is on, such as v1. Null until it is on the runtime.
The PHP change still running, and the error of the last one that failed.
Fields
The PHP change still running, in short. Null when none is.
Always null at present.
The site's custom php.ini.
Fields
The lines the Control Panel writes at the top of the file.
The size of the file as it is stored, the banner included.
The text, exactly as it was saved. Empty when there is none.
The settings form directives the php.ini sets, with the line that sets each.
Fields of each item
Empty when the site's PHP version has no catalogue.
Fields of each item
Extensions that cannot be on at the same time.
extension or zend_extension.
True when the platform keeps it on or off for this site.
The name a change sends in extensions.
True when the application's requirements name it.
PHP-FPM as it applies to the site. A null value is inherited from the platform.
Fields
The values pm may take, and the range of max_requests and process_idle_timeout.
The pool's figures when they were last read (active, idle, max_children_reached, read_at), or null.
Set by the site's size; it cannot be changed here.
dynamic, ondemand or static.
Seconds. Applies only with pm ondemand.
Where each value comes from, such as platform, site or package.
The PHP the site runs.
Fields
new for the runtime's PHP, legacy for the earlier one.
Such as 8.4.
The full version, such as 8.4.9, when it is known.
Format: date-time.
Set when Corefinity has locked the site's PHP configuration, with the reason. Null otherwise.
What the application asks of PHP, as it was last stored. Null before the first read. GET …/php-runtime/requirements answers it with what is missing.
The environment's role, such as production or staging.
Fields
The settings form. A site that is not on the runtime has only memory limit, upload size and execution time.
Fields of each item
What the value may be. Memory, upload size and execution time carry default, min, max, unit (bytes or seconds), step and sometimes options. Every other directive carries type (size, int, enum, bool, expr, timezone or path) and what that type needs.
Fields
The value in effect.
Such as production or platform.
The directive, as a change sends it in settings.
Where the value in effect comes from: site (set for the site), ini (the custom php.ini), platform, image (PHP's own default) or locked (kept fixed by the platform).
The value set for the site. Null when none is set, so the default applies. Sizes are in bytes.
What GET / answers. Null for a site with a custom size.
The shared memory OPcache, its JIT and APCu may use together (cap_mb, and that as a percent of PHP's memory). Null for a site that is not on the runtime.
Fields of each item
The write token. Send it back with every change; a change made since your read is refused stale.
Fields of each item
A sentence for each entry of requires_ack, by its key. An empty list when nothing is asked.
Whether the site may move to this version.
What moving to this version changes besides the version.
The day the version stops getting security fixes.
Why it is not allowed, when it is not.
What acknowledge must carry to move to this version, such as eol.
Such as supported, security or eol.
Major and minor, such as 8.4.
Fields of each item
Null on production and on a site that is not on the runtime.
Sent only when the change waits for the site's window.
Fields of each item
The window the change waits for. Sent only with queued, while maintenance windows are on for your company.
The date of the window the change waits for. Sent only with queued.
Fields of the 201 answer
True when the change also moves the site onto the runtime.
The id of the pending change. Sent only with queued. At least 1.
The operation that applies the change. Null when nothing differs and when the change was queued.
A site's PHP configuration.
Fields
True when the site is on the runtime. Extensions, the full settings form, PHP-FPM, Xdebug and the php.ini need it.
Whether a site is on the runtime, and whether it can move onto it.
Fields
Why the site cannot move at once, when it cannot.
True when the site is on the runtime.
The date Corefinity plans to move the site, if one is set.
The date of the window the move is queued for, if it is queued.
The runtime revision the site is on, such as v1. Null until it is on the runtime.
The PHP change still running, and the error of the last one that failed.
Fields
The PHP change still running, in short. Null when none is.
Always null at present.
The site's custom php.ini.
Fields
The lines the Control Panel writes at the top of the file.
The size of the file as it is stored, the banner included.
The text, exactly as it was saved. Empty when there is none.
The settings form directives the php.ini sets, with the line that sets each.
Fields of each item
Empty when the site's PHP version has no catalogue.
Fields of each item
Extensions that cannot be on at the same time.
extension or zend_extension.
True when the platform keeps it on or off for this site.
The name a change sends in extensions.
True when the application's requirements name it.
PHP-FPM as it applies to the site. A null value is inherited from the platform.
Fields
The values pm may take, and the range of max_requests and process_idle_timeout.
The pool's figures when they were last read (active, idle, max_children_reached, read_at), or null.
Set by the site's size; it cannot be changed here.
dynamic, ondemand or static.
Seconds. Applies only with pm ondemand.
Where each value comes from, such as platform, site or package.
The PHP the site runs.
Fields
new for the runtime's PHP, legacy for the earlier one.
Such as 8.4.
The full version, such as 8.4.9, when it is known.
Format: date-time.
Set when Corefinity has locked the site's PHP configuration, with the reason. Null otherwise.
What the application asks of PHP, as it was last stored. Null before the first read. GET …/php-runtime/requirements answers it with what is missing.
The environment's role, such as production or staging.
Fields
The settings form. A site that is not on the runtime has only memory limit, upload size and execution time.
Fields of each item
What the value may be. Memory, upload size and execution time carry default, min, max, unit (bytes or seconds), step and sometimes options. Every other directive carries type (size, int, enum, bool, expr, timezone or path) and what that type needs.
Fields
The value in effect.
Such as production or platform.
The directive, as a change sends it in settings.
Where the value in effect comes from: site (set for the site), ini (the custom php.ini), platform, image (PHP's own default) or locked (kept fixed by the platform).
The value set for the site. Null when none is set, so the default applies. Sizes are in bytes.
What GET / answers. Null for a site with a custom size.
The shared memory OPcache, its JIT and APCu may use together (cap_mb, and that as a percent of PHP's memory). Null for a site that is not on the runtime.
Fields of each item
The write token. Send it back with every change; a change made since your read is refused stale.
Fields of each item
A sentence for each entry of requires_ack, by its key. An empty list when nothing is asked.
Whether the site may move to this version.
What moving to this version changes besides the version.
The day the version stops getting security fixes.
Why it is not allowed, when it is not.
What acknowledge must carry to move to this version, such as eol.
Such as supported, security or eol.
Major and minor, such as 8.4.
Fields of each item
Null on production and on a site that is not on the runtime.
Sent only when the change waits for the site's window.
Fields of each item
The window the change waits for. Sent only with queued, while maintenance windows are on for your company.
The date of the window the change waits for. Sent only with queued.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
409 | runtime_locked | Corefinity has locked this environment's PHP configuration. Contact support to change it. |
409 | stale | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
422 | ini_invalid | open_basedir: The platform sets the paths PHP serves. |
422 | invalid | Fix the field named in field; errors says why. |
422 | feature_off | This feature is not on for your organisation yet. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | none | Read the message; it says what happened. |
503 | switched_off | Corefinity has switched this action off for the moment. Try again later. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/php-runtime \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"extensions": [
"imagick",
"redis"
],
"version": 12
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/sites/1042/php-runtime', [
'extensions' => [
'imagick',
'redis',
],
'version' => 12,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/php-runtime', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
extensions: [
'imagick',
'redis',
],
version: 12,
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.put(
"https://manage.corefinity.com/api/corestack/sites/1042/php-runtime",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"extensions": [
"imagick",
"redis",
],
"version": 12,
},
)
data = res.json() if res.content else None{
"adopting": false,
"operation": null,
"php_runtime": {
"adopted": true,
"adoption": {
"adopt_now_refusal": null,
"adopted": true,
"can_adopt_now": false,
"can_adopt_tonight": false,
"in_progress": false,
"planned_for": null,
"queued_for": null,
"revision": "v1"
},
"apply": {
"error": null,
"operation": null,
"pending_tonight": null
},
"custom_ini": {
"banner": [
"; cf-runtime v1 php-custom.ini site=rs-northwind-harbourandfinch-example-com",
"; Managed by the control panel. Edits made here are overwritten."
],
"bytes": 145,
"content": "realpath_cache_size = 8M\n",
"lines": 1,
"max_bytes": 32768,
"overrides": [
{
"directive": "realpath_cache_size",
"line": 1
}
]
},
"extensions": [
{
"available": true,
"conflicts": [],
"description": "A client for Redis and Valkey, for caches, sessions and queues.",
"enabled": false,
"group": "caching",
"kind": "extension",
"label": "Redis",
"locked": false,
"locked_reason": null,
"name": "redis",
"non_production_only": false,
"recommended": true,
"required_by_app": false,
"version": "6.3.0"
}
],
"fpm": {
"bounds": {
"max_requests": {
"max": 100000,
"min": 100
},
"pm": [
"dynamic",
"ondemand",
"static"
],
"process_idle_timeout": {
"max": 300,
"min": 5
}
},
"live": null,
"max_children": null,
"max_requests": 500,
"pm": "dynamic",
"process_idle_timeout": null,
"source": {
"max_children": "package",
"max_requests": "platform",
"pm": "platform",
"process_idle_timeout": "platform"
}
},
"image": {
"line": "new",
"minor": "8.4",
"patch": "8.4.9"
},
"last_applied_at": null,
"locked": null,
"requirements": {
"application": {
"name": "WordPress",
"version": "6.8.3"
},
"ext": {
"by": {
"imagick": [
"wordpress"
]
},
"required": [
"ext-json",
"ext-mysqli",
"ext-imagick"
]
},
"php": {
"constraint": ">=7.4",
"packages": []
},
"read_at": "2026-11-08T09:16:40Z",
"source": "probe"
},
"role": "production",
"settings": {
"fields": [
{
"bounds": {
"max": 200000,
"min": 1000,
"type": "int"
},
"effective": 20000,
"locked": false,
"locked_reason": null,
"name": "max_input_vars",
"source": "site",
"value": 20000
}
],
"legacy": {
"apply": {
"applied_at": null,
"error": null,
"operation": null,
"state": "applied",
"state_label": "Applied"
},
"bounds": {
"container_memory_limit_bytes": 2617245696,
"max_execution_time": {
"options": [
60,
120,
300
]
},
"memory_headroom_bytes": 268435456,
"memory_limit": {
"max": 2147483648,
"min": 134217728,
"step": 67108864
},
"platform": "wordpress",
"post_max_size": {
"max": 1073741824,
"min": 2097152,
"step": 1048576
},
"tier": "M",
"upload_max_filesize": {
"max": 1073741824,
"min": 2097152,
"step": 1048576
}
},
"container_memory_limit_bytes": 2617245696,
"notes": [],
"php_version": "8.4",
"platform": "wordpress",
"settings": {
"max_execution_time": {
"default": 300,
"max": 300,
"min": 60,
"options": [
60,
120,
300
],
"step": 60,
"unit": "seconds",
"value": 300
},
"memory_limit": {
"default": 536870912,
"max": 2147483648,
"min": 134217728,
"step": 67108864,
"unit": "bytes",
"value": 536870912
},
"post_max_size": {
"default": 268435456,
"max": 1073741824,
"min": 2097152,
"step": 1048576,
"unit": "bytes",
"value": 268435456
},
"upload_max_filesize": {
"default": 268435456,
"max": 1073741824,
"min": 2097152,
"step": 1048576,
"unit": "bytes",
"value": 268435456
}
},
"tier": "M",
"version": 12
},
"shm": {
"cap_mb": 998,
"percent": 40
}
},
"tools": [
{
"label": "7-Zip",
"name": "7z",
"path": "/usr/bin/7z",
"purpose": "Packs and unpacks 7z and other archives.",
"version": "25.01"
}
],
"version": 12,
"versions": [
{
"ack_detail": [],
"allowed": false,
"changes": [],
"current": true,
"eol_date": "2028-12-31",
"label": "PHP 8.4",
"reason": "This is the current version",
"requires_ack": [],
"status": "supported",
"version": "8.4"
}
],
"warnings": [],
"xdebug": null
},
"warnings": []
}{
"adopting": false,
"item_id": 5120,
"operation": null,
"php_runtime": {
"adopted": true,
"adoption": {
"adopt_now_refusal": null,
"adopted": true,
"can_adopt_now": false,
"can_adopt_tonight": false,
"in_progress": false,
"planned_for": null,
"queued_for": null,
"revision": "v1"
},
"apply": {
"error": null,
"operation": null,
"pending_tonight": null
},
"custom_ini": {
"banner": [
"; cf-runtime v1 php-custom.ini site=rs-northwind-harbourandfinch-example-com",
"; Managed by the control panel. Edits made here are overwritten."
],
"bytes": 145,
"content": "realpath_cache_size = 8M\n",
"lines": 1,
"max_bytes": 32768,
"overrides": [
{
"directive": "realpath_cache_size",
"line": 1
}
]
},
"extensions": [
{
"available": true,
"conflicts": [],
"description": "A client for Redis and Valkey, for caches, sessions and queues.",
"enabled": false,
"group": "caching",
"kind": "extension",
"label": "Redis",
"locked": false,
"locked_reason": null,
"name": "redis",
"non_production_only": false,
"recommended": true,
"required_by_app": false,
"version": "6.3.0"
}
],
"fpm": {
"bounds": {
"max_requests": {
"max": 100000,
"min": 100
},
"pm": [
"dynamic",
"ondemand",
"static"
],
"process_idle_timeout": {
"max": 300,
"min": 5
}
},
"live": null,
"max_children": null,
"max_requests": 500,
"pm": "dynamic",
"process_idle_timeout": null,
"source": {
"max_children": "package",
"max_requests": "platform",
"pm": "platform",
"process_idle_timeout": "platform"
}
},
"image": {
"line": "new",
"minor": "8.4",
"patch": "8.4.9"
},
"last_applied_at": null,
"locked": null,
"requirements": {
"application": {
"name": "WordPress",
"version": "6.8.3"
},
"ext": {
"by": {
"imagick": [
"wordpress"
]
},
"required": [
"ext-json",
"ext-mysqli",
"ext-imagick"
]
},
"php": {
"constraint": ">=7.4",
"packages": []
},
"read_at": "2026-11-08T09:16:40Z",
"source": "probe"
},
"role": "production",
"settings": {
"fields": [
{
"bounds": {
"max": 200000,
"min": 1000,
"type": "int"
},
"effective": 20000,
"locked": false,
"locked_reason": null,
"name": "max_input_vars",
"source": "site",
"value": 20000
}
],
"legacy": {
"apply": {
"applied_at": null,
"error": null,
"operation": null,
"state": "applied",
"state_label": "Applied"
},
"bounds": {
"container_memory_limit_bytes": 2617245696,
"max_execution_time": {
"options": [
60,
120,
300
]
},
"memory_headroom_bytes": 268435456,
"memory_limit": {
"max": 2147483648,
"min": 134217728,
"step": 67108864
},
"platform": "wordpress",
"post_max_size": {
"max": 1073741824,
"min": 2097152,
"step": 1048576
},
"tier": "M",
"upload_max_filesize": {
"max": 1073741824,
"min": 2097152,
"step": 1048576
}
},
"container_memory_limit_bytes": 2617245696,
"notes": [],
"php_version": "8.4",
"platform": "wordpress",
"settings": {
"max_execution_time": {
"default": 300,
"max": 300,
"min": 60,
"options": [
60,
120,
300
],
"step": 60,
"unit": "seconds",
"value": 300
},
"memory_limit": {
"default": 536870912,
"max": 2147483648,
"min": 134217728,
"step": 67108864,
"unit": "bytes",
"value": 536870912
},
"post_max_size": {
"default": 268435456,
"max": 1073741824,
"min": 2097152,
"step": 1048576,
"unit": "bytes",
"value": 268435456
},
"upload_max_filesize": {
"default": 268435456,
"max": 1073741824,
"min": 2097152,
"step": 1048576,
"unit": "bytes",
"value": 268435456
}
},
"tier": "M",
"version": 12
},
"shm": {
"cap_mb": 998,
"percent": 40
}
},
"tools": [
{
"label": "7-Zip",
"name": "7z",
"path": "/usr/bin/7z",
"purpose": "Packs and unpacks 7z and other archives.",
"version": "25.01"
}
],
"version": 12,
"versions": [
{
"ack_detail": [],
"allowed": false,
"changes": [],
"current": true,
"eol_date": "2028-12-31",
"label": "PHP 8.4",
"reason": "This is the current version",
"requires_ack": [],
"status": "supported",
"version": "8.4"
}
],
"warnings": [],
"xdebug": null
},
"queued": true,
"warnings": [],
"window_date": "2026-11-09"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "busy",
"message": "Another change to this site is in progress. Wait for it to finish.",
"reason": "busy"
}{
"code": "ini_invalid",
"diagnostics": [
{
"code": "locked",
"column": 1,
"end_column": 16,
"line": 1,
"message": "open_basedir: The platform sets the paths PHP serves.",
"severity": "error"
}
],
"errors": [],
"message": "open_basedir: The platform sets the paths PHP serves.",
"reason": "ini_invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"message": "The change could not be saved. Contact support."
}{
"code": "switched_off",
"message": "PHP changes are paused while commands are switched off. Try again later.",
"reason": "switched_off"
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.