weierophinney/swoole-src

Programmatic Server for PHP with Async IO, Coroutines and Fibers: Secure, Reliable, High performance

Open Swoole is an event-driven asynchronous & coroutine-based concurrency networking communication engine with high performance written in C++ for PHP.

Documentation & Community

• Documentation: https://www.swoole.co.uk/docs
• Twitter: https://twitter.com/openswoole
• Join Slack Group: https://goo.gl/forms/wooTTDmhbu30x4qC3
• IDE Helper & API: https://github.com/openswoole/ide-helper

Installation

As with any open source project, Open Swoole always provides the most reliable stability and the most powerful features in the latest released version. Please ensure as much as possible that you are using the latest version.

Compiling requirements

• Linux, OS X or Cygwin, WSL
• PHP 7.2.0 or later (The higher the version, the better the performance.)
• GCC 4.8 or later

1. Install via PECL (beginners)

pecl install openswoole

2. Install from source (recommended)

Please download the source packages from Releases or:

git clone https://github.com/openswoole/swoole-src.git && \
cd swoole-src
git checkout v4.7.2

Compile and install at the source folder:

phpize && \
./configure && \
make && make install

Enable extension in PHP

After compiling and installing to the system successfully, you have to add a new line extension=openswoole.so to php.ini to enable Open Swoole extension. It is recommended to be added after all the other extensions because openswoole may depend on extensions: sockets, mysqlnd, curl etc.

Extra compiler configurations

for example: ./configure --enable-openssl --enable-sockets

• --enable-openssl or --with-openssl-dir=DIR
• --enable-sockets
• --enable-http2
• --enable-mysqlnd (need mysqlnd, it just for supporting $mysql->escape method)
• --enable-swoole-json
• --enable-swoole-curl

Upgrade

If you upgrade from source, don't forget to make clean before you upgrade your swoole

1. pecl upgrade openswoole
2. cd swoole-src && git pull && make clean && make && sudo make install
3. if you change your PHP version, please re-run phpize clean && phpize then try to compile

Contribution

Your contributions to Open Swoole development are welcome.

• Report issues and feedback
• Submit fixes, features via Pull Request

Contributors

This project exists thanks to all the contributors who contribute to the orignal Swoole project. [Contributors].

Security issues

Security issues should be reported privately, via email, to the Open Swoole develop team [email protected]. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message.

Frameworks & Components

PR are welcome if your framework is using openswoole

• Laravel Octane Laravel Octane supercharges your application's performance by serving your application using high-powered application servers.
• PHP Runtime make it easy to run any kind of PHP Application (Symfony, Laravel, PSR7, Native) with all kind of Runtimes like OpenSwoole, Bref, Google Cloud Functions, Roadrunner and React PHP with minimal configuration.

License

Apache License Version 2.0 see http://www.apache.org/licenses/LICENSE-2.0.html