Download the PHP package glzjin/laravel-s without Composer

LaravelS - standing on the shoulders of giants

🚀 Speed up Laravel/Lumen by Swoole, 'S' means Swoole, Speed, High performance.

中文文档

Features

• High performance Swoole

• Built-in Http/WebSocket server

• Memory resident

• Asynchronous event listening

• Asynchronous task queue

• Millisecond cron job

• Gracefully reload

• Automatically reload when code is modified

• Support Laravel/Lumen, good compatibility

• Simple & Out of the box

Requirements

Install

1.Require package via Composer(packagist).

2.Add service provider.

• Laravel: in config/app.php file

• Lumen: in bootstrap/app.php file

3.Publish configuration.

Suggest that do publish after upgrade LaravelS every time

Special for Lumen: you DO NOT need to load this configuration manually in bootstrap/app.php file, LaravelS will load it automatically.

4.Change config/laravels.php: listen_ip, listen_port, refer Settings.

Run demo

php artisan laravels {start|stop|restart|reload|publish}

Cooperate with Nginx (Recommended)

Cooperate with Apache

Enable WebSocket server

The Listening address of WebSocket Sever is the same as Http Server.

1.Create WebSocket Handler class, and implement interface WebsocketHandlerInterface.

2.Modify config/laravels.php.

3.Use swoole_table to bind FD & UserId, optional, Swoole Table Demo. Also you can use the other global storage services, like Redis/Memcached/MySQL, but be careful that FD will be possible conflicting between multiple Swoole Servers.

4.Cooperate with Nginx (Recommended)

Refer WebSocket Proxy

Listen events

System events

Usually, you can reset/destroy some global/static variables, or change the current Request/Response object.

• laravels.received_request After LaravelS parsed swoole_http_request to Illuminate\Http\Request, before Laravel's Kernel handles this request.

• laravels.generated_response After Laravel's Kernel handled the request, before LaravelS parses Illuminate\Http\Response to swoole_http_response.

Customized asynchronous events

This feature depends on AsyncTask of Swoole, your need to set swoole.task_worker_num in config/laravels.php firstly. The performance of asynchronous event processing is influenced by number of Swoole task process, you need to set task_worker_num appropriately.

1.Create event class.

2.Create listener class.

3.Bind event & listeners.

4.Fire event.

Asynchronous task queue

This feature depends on AsyncTask of Swoole, your need to set swoole.task_worker_num in config/laravels.php firstly. The performance of task processing is influenced by number of Swoole task process, you need to set task_worker_num appropriately.

1.Create task class.

2.Deliver task.

Millisecond cron job

Wrapper cron job base on Swoole's Millisecond Timer, replace Linux Crontab.

1.Create cron job class.

2.bind cron job.

Get the instance of swoole_server in your project

Use swoole_table

1.Define swoole_table, support multiple.

All defined tables will be created before Swoole starting.

2.Access swoole_table: all table instances will be bound on swoole_server, access by app('swoole')->xxxTable.

Important notices

• Get all info of request from Illuminate\Http\Request Object, compatible with $_SERVER/$_ENV/$_GET/$_POST/$_FILES/$_COOKIE/$_REQUEST, CANNOT USE $_SESSION.

• Respond by Illuminate\Http\Response Object, compatible with echo/vardump()/print_r()，CANNOT USE functions like header()/setcookie()/http_response_code().

• global, static variables which you declared are need to destroy(reset) manually.

• Infinitely appending element into static/global variable will lead to memory leak.

Known compatible issues

Todo list

1. Connection pool for MySQL/Redis.

2. Wrap coroutine clients for MySQL/Redis/Http.

License

MIT