Symfony integration with Swoole to speed up your applications.
CI Job | Branch master |
Branch develop |
---|---|---|
Circle | ||
CodeCov | ||
Travis |
-
Make sure you have installed proper Swoole PHP Extension and pass other requirements.
-
(optional) Create a new symfony project
composer create-project symfony/skeleton project cd ./project
-
Install bundle in your symfony application
composer require k911/swoole-bundle
-
Edit
config/bundles.php
return [ // ...other bundles K911\Swoole\Bridge\Symfony\Bundle\SwooleBundle::class => ['all' => true], ];
-
Run Swoole HTTP Server
bin/console swoole:server:run
-
Enter http://localhost:9501
-
You can now configure bundle according to your needs
-
Built-in API Server
Swoole Bundle API Server allows to manage Swoole HTTP Server in real time.
- Reload worker processes
- Shutdown server
- Access metrics and settings
-
Improved static files serving
Swoole HTTP Server provides a default static files handler, but it lacks supporting many
Content-Types
. In order to overcome this issue, there is (not yet configurable) Advanced Static Files Server. Static files serving is enabled by default in development environment. Static files directory defaults to%kernel.project_dir%/public
. -
Hot Module Reload (HMR) - for development
Since Swoole HTTP Server runs in Event Loop and do not flush memory between requests, to keep DX equal with normal servers, this bundle uses code replacement techinque, using
inotify
PHP Extension to allow contionus development. It is enabled by default (when extension is found), and requires no additional configuration. You can turn it off in bundle configuration. -
Symfony Messenger integration
Available since version:
0.6
Swoole Server Task Transport has been integrated into this bundle to allow easy execution of asynchronous actions. Documentation of this feature is available here.
- PHP version
>= 7.2.19
- Swoole PHP Extension
>= 4.3.6
- Symfony
>= 4.2.10
Additional requirements to enable specific features:
- Inotify PHP Extension
^2.0.0
to use Hot Module Reload (HMR)
Bundle requires Swoole PHP Extension version 4.3.0 or higher. Active bug fixes are provided only for latest version.
To check your installed version you can run following command:
php -r "echo swoole_version();"
# 4.3.3
To install latest version of swoole use pecl
:
pecl install swoole
Or, to skip interactive questions:
echo "\n" | pecl install swoole