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.
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.