CorefinityCorefinityDocs
Open the Control PanelControl Panel
PHP and runtime · 10 of 22

corestack_php_extensions_update

Set the PHP extensions.

Scope writeRuns as a taskNo secrets returned
On this page

When to use it

Set the full list of optional PHP extensions a row loads (anything left out is turned off), from corestack_php_runtime_get's extensions, at its version; now or tonight.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_php_extensions_update with site_id 4211, extensions ["imagick","intl","redis"], version 3. (Set the PHP extensions.) Tell me what it returned.

Inputs

applystring

now (the default), or tonight in the row's maintenance window. window: the row's next maintenance window (tonight is kept as its alias). Defaults to now.

nowwindowtonight
extensionsarray of stringsRequired

Every optional extension to load, e.g. ["imagick", "redis"]; [] turns them all off. Up to 200 items.

site_idintegerRequired

The row: the site or one of its environments. At least 1.

versionintegerRequired

corestack_php_runtime_get's version: a change made since is refused stale. At least 0.

Example call

tools/call
{
  "name": "corestack_php_extensions_update",
  "arguments": {
    "site_id": 4211,
    "extensions": [
      "imagick",
      "intl",
      "redis"
    ],
    "version": 3
  }
}

If it is refused

ReasonWhat to do
invalid_argumentsAn extension the row cannot load: details.errors lists {field, code, message}, and the entry for extensions carries the Control Panel's code — extension_unknown, extension_unavailable (this minor's build does not offer it), extension_conflict (two that cannot load together), non_production_only, or xdebug (turn Xdebug on with corestack_php_xdebug_set instead). Extensions the platform needs stay on whatever the list says.
staleThe row's PHP configuration changed since you read it; read corestack_php_runtime_get again and call with its new version.
runtime_lockedCorefinity has locked this row's PHP configuration, so nothing was changed; tell the person (Corefinity support can unlock it).
managed_elsewhereAnother control panel manages this row; change it there.
switched_offThe exec kill switch is off, which also stops every PHP change on a row already on the new runtime; stop and tell the person.
feature_offapply: "tonight" needs the maintenance window queue, which is switched off; leave apply out to make the change now.
batch_windowThis change can only apply inside this row's maintenance window, or other maintenance is already queued for it; call again with apply: "tonight".
change_pendingA change is already queued for this row's maintenance window; apply or cancel it first (corestack_pending_changes_list).
runtime_not_adoptedThe row is not on the new runtime yet and cannot move onto it with this save (details.adoption says why); try again once corestack_runtime_get shows it can adopt.
conflictThe row's PHP files were changed outside the Control Panel, and Corefinity staff review them before the next change; nothing was changed; tell the person.
removedThe row has been removed.
deletedThe site is deleted (in its grace period); restore it with corestack_site_restore_deleted first.
provisioningThe site is still being created; wait for corestack_site_provisioning_get to finish.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT