Manages every PHP-FPM version installed on the server from a single page — service state, worker pools, php.ini values, and extensions, each scoped to a specific version. Installed versions are discovered from the FPM config tree, and each one gets its own start, stop, restart, and reload through the root agent; the sidebar badge and dashboard widget show how many of them are currently running. The list of installable versions comes from apt-cache search php.*-fpm combined with what is already present, falling back to a static list when apt is unavailable, and one version can be set as the system default.

Pool management lists the .conf files in a version's pool directory, shows and edits a pool's raw configuration, and creates a pool with a chosen FPM user and socket path or deletes one; any successful pool change triggers a reload of that version so it takes effect. The PHP configuration side reads the full php.ini for viewing, surfaces the commonly-tuned keys as an editable form, and writes changes back. Extensions can be listed as enabled or available and toggled per version.

Installation is handled by install.sh, which adds ppa:ondrej/php on Ubuntu or the Sury repository on Debian when the requested version is not in the base repos, then installs the FPM package and a set of extensions. Viewing requires core.view_components; the action endpoints are admin-gated. The plugin edits config files and controls services — it does not track which website uses which version, and per-site PHP selection lives elsewhere in the panel.

Min Panel Version

1.0.0

Platform

Ubuntu 20.04+ / 22.04+ / 24.04+

License

Free — no key needed

Hooks

php_pool_written

Permissions

core.view_components

VinzaPanel handles installation automatically via the Vinza Store. Make sure the panel agent has internet access to download dependencies.

1.0.9 — New icon in the shared flat style. 1.0.8 — Upload limit 50 MB by default: every version's fpm/php.ini still at PHP's stock upload_max_filesize 2M / post_max_size 8M gets 50M, on install, on a new version and on update; a value set here stays. 1.0.7 — Requests send the panel’s own CSRF token: the cookie was matched by a pattern that also took any cookie whose name ends in “csrftoken” (another app on the same host), and the request was refused with 403. 1.0.6 — Versions table: a Path column with each version's PHP CLI binary (for cron jobs and workers), and an Info button that lists where everything of that version lives — CLI and FPM binaries, both php.ini files, php-fpm.conf, enabled extensions (FPM and CLI), pool configs, socket, FPM log and the extension directory — with whether each exists and a copy button. 1.0.5 — Modules: Enable/Disable now takes effect and shows correctly. The list read the PHP CLI's modules (php -m) as well as FPM's, so a module disabled for FPM still showed as enabled and looked as if Disable did nothing; status now comes from FPM's conf.d only. A toggle that changed nothing, or an FPM reload that failed, is reported instead of shown as done. 1.0.4 — Installing a PHP version on a panel with Vinza Server nodes now says it goes on this panel server only, and links to each node's Components to install it there too (a site uses the PHP of the node it lives on). 1.0.3 — Pool and php.ini edits are checked before they take effect: a pool edit or new pool that PHP-FPM rejects (typo, unknown user) is reverted with php-fpm's error instead of being reported as saved and stopping that PHP version on its next restart. Pool names, pool users (never root), socket paths and php.ini directive names are validated (a pool named "../x" was written outside pool.d). 1.0.2 — Installing another PHP version works again: the OS check overwrote the requested version number, so every install failed with an error naming the OS release instead of PHP. When add-apt-repository cannot reach Launchpad, the Ondrej PPA is added directly with its fingerprint-checked key. 1.0.1 — Install PHP Version now offers every release (8.5–7.4), not just the PHP your OS ships; installing one adds the ondrej PPA (Ubuntu) or Sury (Debian) repository first, which never happened when add-apt-repository was missing. Initial release — multi-version PHP install, pool management, worker tuning, extension manager.

Use VinzaPanel's REST API to download and install this app programmatically.

Download app files

HTTP

POST /plugins/api/download/php-fpm/
Content-Type: application/json

{
  "panel_version": "1.0.0"
}

Example response

JSON

{
  "success": true,
  "plugin_id": "php-fpm",
  "version": "1.0.9",
  "download_url": "..."
}