jon-acker / swoole-bundle

Symfony Swoole Bundle

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

travis Maintainability Test Coverage Open Source Love MIT Licence

Swoole Bundle

Symfony integration with Swoole to speed up your applications.

Quick start guide

  1. Make sure you have installed proper Swoole PHP Extension and pass other requirements.

  2. Create symfony project

    (You can skip this step if you already have a project)

    composer create-project symfony/skeleton project
    
    cd ./project
  3. Install bundle in your symfony application

    composer require k911/swoole-bundle
  4. Edit config/bundles.php

    return [
        // ...other bundles
        K911\Swoole\Bridge\Symfony\Bundle\SwooleBundle::class => ['all' => true],
    ];
  5. Run Swoole HTTP Server

    $ bin/console swoole:server:run
  6. Enter http://localhost:9501

  7. You can now configure bundle according to your needs

Features

  • 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.

Requirements

  • Swoole PHP Extension ^4.0.0
  • Symfony ^4.1

Additional requirements to enable specific features:

Swoole

Bundle requires Swoole PHP Extension version 4.0.0 or higher. Active bugfixes are provided only for latest version.

Version check

To check your installed version you can run following command:

php -r "echo swoole_version();"

# 4.2.3

Installation

To install latest version of swoole use pecl:

pecl install swoole

Or, to skip interactive questions:

echo "\n" | pecl install swoole 

About

Symfony Swoole Bundle

License:MIT License


Languages

Language:PHP 96.0%Language:Shell 4.0%