https://github.com/openswoole/ext-openswoole
Programmatic server for PHP with async IO, coroutines and fibers
https://github.com/openswoole/ext-openswoole
async concurrency coroutines openswoole php
Last synced: 3 days ago
JSON representation
Programmatic server for PHP with async IO, coroutines and fibers
- Host: GitHub
- URL: https://github.com/openswoole/ext-openswoole
- Owner: openswoole
- License: apache-2.0
- Created: 2021-10-13T08:44:11.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-08T22:15:06.000Z (over 1 year ago)
- Last Synced: 2024-09-08T23:27:47.861Z (over 1 year ago)
- Topics: async, concurrency, coroutines, openswoole, php
- Language: C++
- Homepage: https://openswoole.com
- Size: 45 MB
- Stars: 799
- Watchers: 19
- Forks: 50
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
## Open Swoole
Open Swoole is a programmatic server for PHP with async IO, coroutines and fibers: secure, reliable, high performance
+ __Website__:
+ __Twitter__:
+ __Slack__:
+ __Discord__:
+ __IDE Helper__:
## Documentation
Documentation for Open Swoole can be found on the [Open Swoole website](https://openswoole.com/docs).
## Installation
> 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.
### 1. Install or upgrade Open Swoole from multiple distribution channels
Please check [Open Swoole Installation Guide](https://openswoole.com/docs/get-started/installation) about how to install Open Swoole on Ubuntu/CentOS/Windows WSL from Docker, PECL or Binary releases channels.
### 2. Compile from source
#### Compiling requirements
+ Linux, OS X or Cygwin, WSL
+ PHP 8.2.0 or later (The higher the version, the better the performance.)
+ GCC 4.8 or later
Download the source packages from [Releases](https://github.com/openswoole/ext-openswoole/releases) or:
```shell
git clone https://github.com/openswoole/ext-openswoole.git && \
cd ext-openswoole
git checkout v25.2.0
phpize && \
./configure && \
make && make install
```
You can find how to fix [Common Installation Errors](https://openswoole.com/docs/get-started/common-install-errors) if there are errors in the installation.
#### Compile 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-hook-curl`
+ `--with-postgres[=DIR]`
#### Enable Open Swoole extension
After compiling and installing the openswoole extension, you have to add a new line `extension=openswoole.so` at the end of `php.ini` or create a ini file at `conf.d` folder to enable Open Swoole. It is recommended to be added after all the other extensions because openswoole may depend on extensions: sockets, mysqlnd, curl etc.
## Frameworks & Components
> PR are welcome if your framework is using openswoole
- [**Laravel Octane**](https://laravel.com/docs/9.x/octane) Laravel Octane supercharges your application's performance by serving your application using high-powered application servers.
- [**PHP Runtime**](https://github.com/php-runtime) make it easy to run any kind of PHP Application (Symfony, Laravel, PSR7, Native) with all kinds of Runtimes like OpenSwoole, Bref, Google Cloud Functions, Roadrunner and React PHP with minimal configuration.
- [**Mezzio Swoole**](https://docs.mezzio.dev/mezzio-swoole/) allows you to run Mezzio and [PSR-15](https://www.php-fig.org/psr/psr-15/) applications on Open Swoole.
## For Contributors
If you like to involve the maintenance of this repo, it is better to get started by submitting PR, you will be invited to the dev group once there are significant contributions. Or join Slack group firstly, the team will provide mentoring and internal support to help you get started.
* [Report issues and feedback](https://github.com/openswoole/ext-openswoole/issues)
* Submit fixes, features via Pull Request
This project exists thanks to all the historical [[Contributors](https://github.com/openswoole/ext-openswoole/graphs/contributors)].
## Security issues
Security issues should be reported privately, via email, to the Open Swoole develop team [hello@openswoole.com](mailto:hello@openswoole.com). 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.
## License
Open Swoole is open-sourced software licensed under the [Apache 2.0 license](http://www.apache.org/licenses/LICENSE-2.0.html).