Get a site's PHP configuration
Answers the site's PHP: the versions it may move to, the extensions, the settings with their bounds, PHP-FPM, Xdebug, the custom php.ini, warnings and any change still running. version is the write token every change sends back.
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.
Returns
200 The PHP configuration.
Fields of the 200 answer
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.
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. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/php-runtime \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/sites/1042/php-runtime');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/php-runtime', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// 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.get(
"https://manage.corefinity.com/api/corestack/sites/1042/php-runtime",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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": "Keeps compiled PHP code in memory so pages run faster. Always on.",
"enabled": true,
"group": "caching",
"kind": "zend_extension",
"label": "OPcache",
"locked": true,
"locked_reason": "OPcache is always on",
"name": "opcache",
"non_production_only": false,
"recommended": false,
"required_by_app": false,
"version": "8.4.26"
},
{
"available": true,
"conflicts": [],
"description": "Image processing through ImageMagick: resizing, format conversion and PDF thumbnails.",
"enabled": false,
"group": "images",
"kind": "extension",
"label": "Imagick",
"locked": false,
"locked_reason": null,
"name": "imagick",
"non_production_only": false,
"recommended": true,
"required_by_app": true,
"version": "3.8.1"
},
{
"available": true,
"conflicts": [],
"description": "Connects to MySQL and MariaDB databases.",
"enabled": true,
"group": "databases",
"kind": "extension",
"label": "MySQLi",
"locked": true,
"locked_reason": "WordPress needs MySQLi",
"name": "mysqli",
"non_production_only": false,
"recommended": true,
"required_by_app": true,
"version": "8.4.26"
},
{
"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": {
"default": 536870912,
"max": 2147483648,
"min": 134217728,
"step": 67108864,
"unit": "bytes"
},
"effective": 536870912,
"locked": false,
"locked_reason": null,
"name": "memory_limit",
"source": "site",
"value": 536870912
},
{
"bounds": {
"default": 300,
"max": 300,
"min": 60,
"options": [
60,
120,
300
],
"step": 60,
"unit": "seconds"
},
"effective": 300,
"locked": false,
"locked_reason": null,
"name": "max_execution_time",
"source": "site",
"value": 300
},
{
"bounds": {
"max": 200000,
"min": 1000,
"type": "int"
},
"effective": 20000,
"locked": false,
"locked_reason": null,
"name": "max_input_vars",
"source": "site",
"value": 20000
},
{
"bounds": {
"type": "bool"
},
"effective": false,
"locked": true,
"locked_reason": "production",
"name": "display_errors",
"source": "locked",
"value": null
}
],
"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"
},
{
"label": "avifenc",
"name": "avifenc",
"path": "/usr/bin/avifenc",
"purpose": "Converts images to AVIF.",
"version": "1.2.1"
}
],
"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
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}