CorefinityCorefinityDocs
Open the Control PanelControl Panel
PHP · 7 of 11

Get what the application needs from PHP

Answers what the application asks of PHP, as last read from the site, with any extensions it needs that are not loaded and whether the PHP version is outside the range it accepts. refresh=1 reads the site again first, at most once every ten minutes. Try-it is off because that read runs a command on the site.

GET/api/corestack/sites/{site}/php-runtime/requirements

Path parameters

siteintegerRequired

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.

Query parameters

refreshstring

Send 1 to read the running site again before answering.

10truefalse

Returns

200 The requirements. Every field is null or empty until the site has been read once.

Fields of the 200 answer
applicationobjectRequired
Fields
namestring or nullRequired
versionstring or nullRequired
extobjectRequired
Fields
byobjectRequired

For an extension, the packages that ask for it. An empty list when none is recorded.

requiredarray of stringsRequired

The extensions the application needs, as ext-<name>.

missing_extensionsarray of stringsRequired

The required extensions that are not loaded on the site, by name.

outside_rangebooleanRequired

True when the site's PHP version is outside the range the application accepts.

phpobjectRequired
Fields
constraintstring or nullRequired

The PHP range the application names, such as >=8.2.

packagesarray of objectsRequired

The packages that name a PHP range of their own, each with name, version and constraint.

rangestring or nullRequired

The PHP versions on offer that satisfy every range the application carries.

read_atstring or nullRequired

Format: date-time.

sourcestring or nullRequired

deploy (read from a deployment) or probe (read from the running site). Null before the first read.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409layout_unknownThe site's htdocs is not a release the control panel deployed, so the application's requirements cannot be read from it.
409not_runningThe site, environment or deployment is not running. Read the message: where it can be started or will recover, start it or wait, then try again.
422stringstring.
429rate_limitedWait for the seconds in Retry-After.
503connect_failedThe cluster could not be reached.
503temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
503switched_offCorefinity 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 https://manage.corefinity.com/api/corestack/sites/1042/php-runtime/requirements \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "application": {
    "name": "WordPress",
    "version": "6.8.3"
  },
  "ext": {
    "by": {
      "imagick": [
        "wordpress"
      ]
    },
    "required": [
      "ext-json",
      "ext-mysqli",
      "ext-imagick"
    ]
  },
  "missing_extensions": [
    "imagick"
  ],
  "outside_range": false,
  "php": {
    "constraint": ">=7.4",
    "packages": [],
    "range": "8.4"
  },
  "read_at": "2026-11-08T09:16:40Z",
  "source": "probe"
}
Try it

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.

Was this helpful?
Open in ClaudeOpen in ChatGPT