Developer tool

PHP-FPM Config Generator

Generate a PHP-FPM pool configuration file from pool name, socket/listen settings, and process manager options.

How it works

What it does

The PHP-FPM Config Generator creates a pool configuration fragment (for example www-pool.conf) from inputs like pool name, listen address or socket, user/group style settings, and process manager parameters. Use it as a template you review before deploying to your own hosts.

When to use it

  • Creating a dedicated pool per site instead of a shared default
  • Documenting a reproducible pool for Docker/Ansible
  • Translating calculator results into concrete pm.* directives

How input is processed safely

Output is downloadable/copyable text only. The generator does not write into this server’s FPM configuration directories and does not reload PHP-FPM. Always validate users, sockets, and paths against your distribution’s layout.

Examples

  • Unix socket pool for Nginx fastcgi_pass
  • Dynamic pm with start/min/max spare servers filled in
  • Separate pool names for staging vs production on one host

Common mistakes

  • Socket permissions that Nginx cannot access
  • Copying Ubuntu paths onto RHEL/Alma layouts unchanged
  • Running the pool as the wrong user relative to site file ownership

Dedicated pools isolate noisy neighbors: a heavy admin area can use different limits than a public API. Naming pools clearly (site-www, site-horizon) makes metrics and logs easier to read under pressure.

Socket vs TCP is an environment choice. Unix sockets are common on single-host Nginx+FPM. TCP helps across containers/VMs but requires stricter firewalling. Whatever you choose, keep the Nginx fastcgi_pass target synchronized with the pool listen directive.

Review user/group lines against your distribution. Incorrect ownership produces 502s that look like application outages. Always test on staging with a real request through the web server, not only php-fpm -t.

Practical tips

  • Keep inputs small and representative; huge pastes slow feedback and raise risk of accidental secret disclosure.
  • After using PHP-FPM Config Generator, verify the result in your own environment (correct SAPI, correct host, correct project root).
  • Cross-link findings to ZendStudio.net PHP error guides and IDE setup pages when the next step is configuration rather than code edits.
  • Prefer repeatable project tooling (CI, Composer scripts, IDE inspections) for repo-wide enforcement; this page is for interactive problem-solving.

Privacy note

Pool files can include paths and usernames. Avoid embedding secrets; FPM pools are not the place for application API keys.

Run in browser

AJAX processing only. No remote PHP execution sandbox. Results are not indexed.

Inputs are processed for this request only and are not stored in analytics. Object unserialize and arbitrary PHP execution are blocked.

Safety notes

  • Submitted tool contents are not written to analytics or search logs.
  • This site never evaluates arbitrary PHP from the browser.
  • Generated configs are starting points—validate on a staging host before production.