AdapterMan - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #ai #go #android #rust #deep-learning #nodejs #java #windows #cli #security #pytorch #openai

AdapterMan

(★ 857)

Boost the performance of nearly any PHP app effortlessly with Workerman, enabling faster and asynchronous execution—all without modifying a single line of code in your framework or app. Additionally, leverage Workerman as a powerful Serverless solution for scalable, event-driven workloads. It's lightweight design and high efficiency

File Explorer

Download Latest Version (.zip)

- - test.yml
- FUNDING.yml
- bolt.md
- caddy-config.md
- drupal.md
- laravel.md
- lumen.md
- nginx-config.md
- README.md
- slim.md
- symfony.md
- thinkphp-cn.md
- thinkphp.md
- - index.php
  - laravel.php
  - lumen.php
  - think.php
- - AdapterFunctions.php
  - AdapterSessionFunctions.php
- Adapterman.php
- Http.php
- ParseMultipart.php
- Session.php
- start.php
- - ExtVarsToUnderscore.php
  - SendData.php
- - ChunkedEncodingTest.php
  - ConvertExtVarToUnderscoreTest.php
  - CookiesTest.php
  - GetTest.php
  - HttpMethodsTest.php
  - IpPortTest.php
  - PostTest.php
  - RequestHeadersTest.php
  - StatusTest.php
  - UploadTest.php
- - Adapterman.php
  - PhpCli.php
  - Workerman.php
- - ExampleTest.php
- AdaptermanServer.php
- Pest.php
- README.md
- RunServer.php
- ServerTestCase.php
.gitattributes
.gitignore
adapterman
cli-php.ini
composer.json
LICENSE.txt
phpunit.xml.dist
README.md

# Installation Guide

1. Get the code

git clone https://github.com/joanhey/AdapterMan

Downloads the entire project code from GitHub to your computer.

cd AdapterMan

Moves into the project folder you just downloaded.

2. PHP (Composer)

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
PHP A PHP runtime is required.
Composer The package manager used to install PHP libraries.

composer require joanhey/adapterman

Type this command into your terminal and run it.

├── composer.json

Type this command into your terminal and run it.

✅ Run it with a built-in server like php -S localhost:8000, then open http://localhost:8000 in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="https://user-images.githubusercontent.com/249085/200214022-c2c45753-368c-4e28-8415-2b3cadca9907.png" />
  
</p>

[![Tests Adapterman](https://github.com/joanhey/AdapterMan/actions/workflows/test.yml/badge.svg)](https://github.com/joanhey/AdapterMan/actions/workflows/test.yml)
[![GitHub release](https://img.shields.io/github/release/joanhey/adapterman.svg)](https://github.com/joanhey/adapterman/releases/latest)
[![GitHub](https://img.shields.io/github/license/joanhey/adapterman)](https://github.com/joanhey/AdapterMan/blob/master/LICENSE.txt)

**Faster, More Scalable Apps with Serverless Capabilities**

Run nearly any PHP application seamlessly using the async, event-driven [Workerman](https://github.com/walkor/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.

![image](https://user-images.githubusercontent.com/249085/209589643-5b464656-4d44-4879-9bbc-deb49582a57b.png)

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
![image](https://user-images.githubusercontent.com/249085/209320777-13d1cc25-f350-43a4-ba2f-4db0a92c7b7a.png)
Latency
![image](https://user-images.githubusercontent.com/249085/209321052-6dab2d0e-c630-48d8-a25c-5f1906f08b8f.png)

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

### Laravel 8
With full ORM.

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

![image](https://user-images.githubusercontent.com/249085/200189417-06fa658b-92c3-4c6d-a6e4-1efb3446a513.png)
Latency
![image](https://user-images.githubusercontent.com/249085/200189427-99977bb7-5910-4d17-a47c-7242e8f95f8f.png)

### Slim with Workerman
Without ORM
![image](https://user-images.githubusercontent.com/249085/201919385-ad25e41b-9887-42b7-92c0-d524a5e6aeae.png)

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

## Installation
```
composer require joanhey/adapterman
```
Automatically install Workerman too.

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

- [Symfony](recipes/symfony.md)
- [Laravel](recipes/laravel.md)
- [Lumen](recipes/lumen.md)
- [Slim](recipes/slim.md)

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.

#### Login progress
It's working with Symfony and Laravel

Laravel Orchid admin panel.
![image](https://user-images.githubusercontent.com/249085/197333441-74fff586-b984-492f-8cd1-58fb69774b1f.png)

Drupal showing public pages.
![image](https://user-images.githubusercontent.com/249085/197333512-0f840436-399f-4000-b9af-e6a05a7d30b2.png)