Download the PHP package prsw/amphp-bundle without Composer

AmphpBundle

Replaces PHP-FPM with a long-running async HTTP server for Symfony. All I/O is non-blocking and fiber-based. No more PHP-FPM process overhead.

Features

• Async HTTP server — built on amphp/http-server
• Async Doctrine — non-blocking MySQL/PostgreSQL driver with connection pooling
• WebSocket server — attribute-driven endpoints, no Symfony boot for handshake
• SSE streaming — server-sent events via SseResponse
• Generator-based streaming — async StreamedResponse with yield
• Hot reload — --dev --watch restarts on file changes (requires fswatch)
• Cluster mode — multi-worker with process supervision and graceful restart
• Prometheus metrics — /metrics endpoint with MetricCollectorInterface
• Liveness / Readiness probes — /healthz (no Symfony boot), /readyz (full stack)
• Async Redis — cache, session handler, messenger transport
• Async Mailer — SMTP + HTTP via amphp/http-client

Quick Start

1. Install

Register the bundle if you are not using symfony flex in config/bundles.php:

2. Start the Server

Press Ctrl+C to stop.

3. Add a WebSocket Endpoint

Create a class with the #[WebsocketEndpoint] attribute — no YAML needed:

The bundle auto-discovers #[WebsocketEndpoint] handlers at startup.

CLI Options

Configuration

DBAL pool settings from amphp.dbal are automatically wired into Doctrine's driverOptions. Keep max_connections below your MySQL server's limit (SHOW VARIABLES LIKE 'max_connections'; default 151).

Per-Request Cleanup (Priority Reset System)

After each request, the bundle runs a chain of resetters to release resources and prevent state leaking between requests. Built-in resetters handle the Doctrine connection pool and debug logger; you can add your own via PriorityResetInterface.

How It Works

1. SymfonyRequestHandler calls RequestResetter::reset() in the finally block.
2. RequestResetter sorts all tagged services by priority (highest first) and calls reset() on each.
3. Built-in priorities:
   • User-defined — -255 to 255 (your custom resetters)
   • DebugLoggerResetter — -255 (clears debug logs)

Adding a Custom Resetter

Create a class implementing PriorityResetInterface:

That's it — no manual tagging or service registration needed. The bundle's BootstrapIntegrationPass auto-configures any service implementing PriorityResetInterface with the amphp.resetter tag, and RequestResetter discovers it automatically via the tagged iterator.

Execution Order

Higher priority numbers run first. Use the built-in constants as anchor points:

Real-World Use Cases

• Release custom connection pools (Redis, RabbitMQ, gRPC)
• Clear in-memory caches or request-scoped state
• Reset rate-limit counters or circuit breakers
• Close temporary file handles or streams

Built-in Endpoints

Benchmarks

Results with wrk -t1 -c100 -d30s, 1 worker, APP_ENV=prod, APP_DEBUG=0:

Compared to PHP-FPM with the same Symfony app, the async server eliminates the PHP-FPM process spawn overhead and connection pool contention, yielding higher throughput under concurrent load.

SSE Streaming

Generator-Based Streaming

Prometheus Metrics

Implement MetricCollectorInterface (autotagged amphp.metric_collector):

Optional Integrations