PHP-FPM

aid: php-fpm
name: PHP-FPM
description: PHP-FPM (FastCGI Process Manager) is the primary PHP FastCGI implementation bundled with PHP for handling heavy-loaded
  sites, providing advanced process management with multiple worker pools, graceful start/stop, adaptive process spawning
  (static, dynamic, ondemand), slowlog tracking, and accelerated upload support. It is configured via php.ini-style pool files
  and is typically deployed behind a web server such as Nginx, Apache, Caddy, or LiteSpeed via FastCGI. PHP-FPM exposes operational
  status pages (in plain, JSON, XML, OpenMetrics, and HTML formats) but does not provide a public HTTP API; it runs only on
  POSIX systems that support fork().
type: Index
deliveryModel:
  model: self-hosted
  license: BSD-3-Clause
  open_source: true
  commercial: false
  callable_host: false
  label: Self-hosted open source · you run it yourself
  confidence: high
  source:
  - license
  - openapi
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/php-fpm.png
tags:
- PHP
- FastCGI
- Process Manager
- Web Server
- Application Server
- Open-Source
tags_raw:
- PHP
- FastCGI
- Process Manager
- Web Server
- Application Server
- Open Source
url: https://raw.githubusercontent.com/api-evangelist/php-fpm/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-07-25'
specificationVersion: '0.23'
apis:
- aid: php-fpm:php-fpm-ping-api
  name: PHP-FPM Ping API
  description: PHP-FPM liveness check.
  humanURL: https://www.php.net/manual/en/install.fpm.configuration.php
  baseURL: http://localhost
  tags:
  - Ping
  properties:
  - type: OpenAPI
    url: openapi/php-fpm-ping-api-openapi.yml
- aid: php-fpm:php-fpm-status-api
  name: PHP-FPM Status API
  description: PHP-FPM pool status.
  humanURL: https://www.php.net/manual/en/install.fpm.configuration.php
  baseURL: http://localhost
  tags:
  - Status
  properties:
  - type: OpenAPI
    url: openapi/php-fpm-status-api-openapi.yml
- aid: php-fpm:status-endpoint
  name: PHP-FPM Status Endpoint
  description: Operational status endpoint exposed by PHP-FPM via the pm.status_path directive. Returns pool statistics (active
    processes, idle processes, accepted connections, slow requests) in plain text, JSON, XML, OpenMetrics, or HTML. There
    is no public API; the endpoint is served by the local web server through FastCGI on user-defined paths.
  humanURL: https://www.php.net/manual/en/install.fpm.configuration.php
  baseURL: http://localhost
  tags:
  - Status
  - Monitoring
  - OpenMetrics
  - Process Manager
  properties:
  - type: Documentation
    url: https://www.php.net/manual/en/install.fpm.php
  - type: Configuration
    url: https://www.php.net/manual/en/install.fpm.configuration.php
  - type: Installation
    url: https://www.php.net/manual/en/install.fpm.install.php
common:
- type: IssueTracker
  url: https://github.com/php/php-src/issues
- type: Releases
  url: https://github.com/php/php-src/releases
- type: SecurityPolicy
  url: https://github.com/php/php-src/blob/master/SECURITY.md
- type: ContributionGuide
  url: https://github.com/php/php-src/blob/master/CONTRIBUTING.md
- type: License
  name: BSD-3-Clause
  url: https://github.com/php/php-src/blob/master/LICENSE
- type: AgenticAccess
  url: agentic-access/php-fpm-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/php-fpm-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/php-fpm-domain-security.yml
- type: Website
  url: https://www.php.net/
- type: Documentation
  url: https://www.php.net/manual/en/install.fpm.php
- type: Download
  url: https://www.php.net/downloads.php
- type: GitHubRepository
  url: https://github.com/php/php-src
- type: Issue Tracker
  url: https://github.com/php/php-src/issues
features:
- name: Worker Pool Management
  description: Multiple independent worker pools per FPM instance, each with its own uid/gid, chroot, environment, php.ini
    overrides, and listen socket.
- name: Adaptive Process Spawning
  description: Static, dynamic, and ondemand process management modes that balance latency, memory, and concurrency for different
    workloads.
- name: Slowlog and Diagnostics
  description: Per-pool slowlog captures backtraces of requests that exceed a configurable execution time threshold.
- name: Status and Ping Endpoints
  description: Built-in pm.status_path and ping.path endpoints for health checks and pool-level metrics in plain, JSON, XML,
    OpenMetrics, or HTML.
- name: Accelerated Upload Support
  description: Offload large file uploads to FPM-managed temporary storage to reduce front-end web server load.
- name: Background Task Support
  description: fastcgi_finish_request() lets PHP scripts return a response to the client and continue processing in the background.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-parent: php
x-relationship: product