README.md

September 18, 2025 · View on GitHub

Faster, More Scalable Apps with Serverless Capabilities

Run nearly any PHP application seamlessly using the async, event-driven Workerman without modifying a single line of code in your framework or app.

If your application or framework follows a Front Controller pattern, there’s a 99% chance it will work out of the box.

Minimum requirements:

PHP 8.0 (or higher)
Adapterman 0.7 (requires PHP 8.1)

Currently Compatible With:

Symfony
Laravel
CakePHP
Yii2
Slim
KumbiaPHP
ThinkPHP
Leaf
FlightPHP
Wolff
Phpixie
... (Your app could be next!)

More frameworks and applications are being tested continuously, all without requiring code changes.

Experience enhanced performance and scalability effortlessly.

NEW !!! Workerman shared nothing mode

We started to test it. Experimental still.

Each request is independent and load the .php file, like with PHP-FPM. Using the same .php files.

Framework	JSON	1-query	Multiple queries	Fortunes	Updates	Plaintext
php php-fpm	187,747	97,658	12,784	79,309	2,010	195,283
php workerman	822,930	134,475	15,648	124,923	4,683	1,161,016

Performance bench Worker mode

Results from Techempower benchmark. Without touch a line of code.

Follow https://twitter.com/adaptermanphp for more updates.

Symfony 6

With full ORM Latency

Fw	Plaintext	Json	Single query	Multiple query	Updates	Fortunes
Symfony	38,231	37,557	12,578	10,741	3,420	10,741
Symfony Workerman	210,796	197,059	107,050	13,401	4,062	71,092

Fw	Plaintext	Json	Single query	Multiple query	Updates	Fortunes
Laravel	14,799	14,770	9,263	3,247	1,452	8,354
Laravel Roadrunner	482	478	474	375	359	472
Laravel Swoole	38,824	37,439	21,687	3,958	1,588	16,035
Laravel Laravel s	54,617	49,372	23,677	2,917	1,255	16,696
Laravel Workerman	103,004	99,891	46,001	5,828	1,666	27,158

Slim with Workerman

Without ORM

Framework	Plaintext	JSON	1-query	20-query	Updates	Fortunes
Slim 4	35,251	38,305	34,272	12,579	2,097	32,634
Slim 4 Workerman	134,531	129,393	81,889	15,803	2,456	73,212
Slim 4 Workerman pgsql *			102,926	19,637	14,875	92,752

Without ORM and db class optimized for Workerman

Symfony demo with Workerman

Symfony initialization 0ms and half the time per request.

https://user-images.githubusercontent.com/249085/197399760-5da8311e-5cf1-426a-a89d-ec2a2de43af0.mp4

Tree

Where to create the files (server.php and start.php)

.
├── app(dir)
├── public(dir)
├── vendor(dir)
├── composer.json
├── server.php
└── start.php

Server

server.php

<?php

require_once __DIR__ . '/vendor/autoload.php';

use Adapterman\Adapterman;
use Workerman\Worker;

Adapterman::init();

$http_worker                = new Worker('http://0.0.0.0:8080');
$http_worker->count         = 8;
$http_worker->name          = 'AdapterMan';

$http_worker->onWorkerStart = static function () {
    //init();
    require __DIR__.'/start.php';
};

$http_worker->onMessage = static function ($connection, $request) {

    $connection->send(run());
};

Worker::runAll();

Front Controller

It's different for any fw and app.

We are creating recipes for popular apps and frameworks.

Recommended start.php and leave index.php in public.

We can run the app with Workerman and with php-fpm at the same time.

Available commands in workerman

To run your app.

php server.php start
php server.php start -d
php server.php status
php server.php status -d
php server.php connections
php server.php stop
php server.php stop -g
php server.php restart
php server.php reload
php server.php reload -g

Workerman documentation: https://manual.workerman.net/doc/en/

You can also select a diferent cli php.ini directly:

php -c cli-php.ini server.php start

Help with session issues

I have been using this library internally for over two years to run legacy applications with Workerman. Initially, we developed it primarily for APIs and microservices, so session handling wasn't a key focus during testing. As a result, the session functionality may not be as thoroughly tested or optimized as other features.

If you encounter any issues related to sessions, please let us know so we can investigate and improve compatibility.

It's working with Symfony and Laravel

Laravel Orchid admin panel.

Drupal showing public pages.