corestack_ php_ extensions_ update
Set the PHP extensions.
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
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.
nowwindowtonightextensionsarray 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
{
"name": "corestack_php_extensions_update",
"arguments": {
"site_id": 4211,
"extensions": [
"imagick",
"intl",
"redis"
],
"version": 3
}
}If it is refused
| Reason | What to do |
|---|---|
invalid_arguments | An 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. |
stale | The row's PHP configuration changed since you read it; read corestack_php_runtime_get again and call with its new version. |
runtime_locked | Corefinity has locked this row's PHP configuration, so nothing was changed; tell the person (Corefinity support can unlock it). |
managed_elsewhere | Another control panel manages this row; change it there. |
switched_off | The 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_off | apply: "tonight" needs the maintenance window queue, which is switched off; leave apply out to make the change now. |
batch_window | This change can only apply inside this row's maintenance window, or other maintenance is already queued for it; call again with apply: "tonight". |
change_pending | A change is already queued for this row's maintenance window; apply or cancel it first (corestack_pending_changes_list). |
runtime_not_adopted | The 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. |
conflict | The 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. |
removed | The row has been removed. |
deleted | The site is deleted (in its grace period); restore it with corestack_site_restore_deleted first. |
provisioning | The site is still being created; wait for corestack_site_provisioning_get to finish. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The 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_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |
The same task elsewhere
Was this helpful?