Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/swow/swow
Coroutine-based cross-platform concurrent I/O engine.
https://github.com/swow/swow
async asynchronous coroutine coroutines php
Last synced: about 16 hours ago
JSON representation
Coroutine-based cross-platform concurrent I/O engine.
- Host: GitHub
- URL: https://github.com/swow/swow
- Owner: swow
- License: apache-2.0
- Created: 2020-09-15T07:37:43.000Z (over 4 years ago)
- Default Branch: develop
- Last Pushed: 2024-10-29T04:00:15.000Z (3 months ago)
- Last Synced: 2024-10-29T15:35:14.743Z (3 months ago)
- Topics: async, asynchronous, coroutine, coroutines, php
- Language: C
- Homepage:
- Size: 5.57 MB
- Stars: 1,194
- Watchers: 53
- Forks: 113
- Open Issues: 35
-
Metadata Files:
- Readme: README-CN.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - swow - based concurrency library for PHP | swow | 585 | (C)
- awesome-php-cn - Swow - Swow是一个使用PHP和C编写的高性能纯协程网络通信引擎。它致力于使用最小C核心及多数PHP代码以支持PHP高性能网络编程。 (目录 / 网络通信引擎 Network-Communication-Engine)
README
[English](./README.md) | 中文 | [日本語](./README-JP.md)
🚀 Swow 是一个专注于并发 I/O 的跨平台协程引擎
[![license][license-badge]][license-link]
[![ci][ci-badge]][ci-link]
[![codecov][codecov-badge]][codecov-link]
[![release][release-badge]][release-link]
![❤️][made-with-love-badge]
![php][supported-php-versions-badge]
![platform][supported-platforms-badge]
![architecture][supported-architectures-badge]
## 👾 设计理念
Swow 致力于使用最小 C 核心及多数 PHP 代码以支持 PHP 高性能网络编程，这决定了它在保障关键性能之外，更多的是通过 PHP 代码与 C 内核的无缝融合运作，提供强大的二次开发能力。
此外，它还提供了丰富多样的调试机制与强大且低门槛的调试工具，最大程度地确保开发者免受 BUG 困扰，普通开发者也能通过工具的加持具备接近专家级别的 DEBUG 能力，从而将开发效率最大化。
## 🎮 安装
> 和任何开源项目一样, Swow 总是在**最新的发行版**提供更佳的稳定性和更强大的功能, 请尽量保证你使用的是最新版本。
### 🔎 必要条件
- Linux、 Windows、macOS 等常见操作系统，详见 [发布文档 - 支持的操作系统](https://docs.toast.run/swow-blog/chs/init.html#%E6%94%AF%E6%8C%81%E7%9A%84%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F)
- PHP 8.0.0 或以上版本，推荐使用最新版本
### 👨🎤 通过 Composer 安装 (扩展 + PHP 库)
拉取源码：
```shell
composer require swow/swow
```
然后运行 `vendor/bin` 目录下的自动安装器 `swow-builder` 即可开始安装：
```shell
./vendor/bin/swow-builder --install
```
当你更新了 Swow 的源码时，你最好使用 `rebuild` 选项来重新编译 Swow 再安装：
```shell
./vendor/bin/swow-builder --rebuild --install
```
更多关于 `swow-builder` 的使用方法，请参考 [安装文档 - 通过 Composer 安装](https://docs.toast.run/swow/chs/install.html#%E9%80%9A%E8%BF%87-composer-%E5%AE%89%E8%A3%85)。
### 🐧 手动编译安装 (UNIX-like)
克隆项目（也可以通过 Composer 引入，cd 到 `vendor/swow/swow/ext` 中手动编译）：
```shell
git clone https://github.com/swow/swow.git
````
熟悉的构建三板斧，最后使用root权限安装到系统：
```shell
cd swow/ext && \
phpize && ./configure && \
make clean && make -j && \
sudo make install
```
详见 [安装文档 - 手动编译安装 (UNIX-like)](https://docs.toast.run/swow/chs/install.html#%E6%89%8B%E5%8A%A8%E7%BC%96%E8%AF%91%E5%AE%89%E8%A3%85-unix-like-%E6%88%96-cygwinmsyswsl)。
### Ⓜ️ 手动编译安装 (Windows)
详见 [安装文档 - 手动编译安装 (Windows)](https://docs.toast.run/swow/chs/install.html#%E6%89%8B%E5%8A%A8%E7%BC%96%E8%AF%91%E5%AE%89%E8%A3%85-windows)。
也可在 [最新的发行版](https://github.com/swow/swow/releases/latest) 中直接下载 DLL。
## 🔰️ 安全问题
安全问题应该通过邮件私下报告给 [[email protected]](mailto:[email protected])。
你将在 24 小时内收到回复，如果因为某些原因你没有收到回复，请通过回复原始邮件的方式跟进，以确保我们收到了你的原始邮件。
## 🖊️ 贡献
你的贡献对于 Swow 的发展至关重要！
你可以通过以下方式来贡献：
* [报告问题与反馈](https://github.com/swow/swow/issues)
* [通过 Pull Request 提交修复补丁或新的特性实现](https://github.com/swow/swow/pulls)
* [帮助我们完善文档 (通过 GitHub 贡献)](https://github.com/toastrun/docs.toast.run)
## ❤️ 贡献者
PHP 高性能协程网络通信引擎开发之路曲高和寡，这是一项高处不胜寒的开源工作。
非常感谢以下小伙伴对于 Swow 项目的代码贡献，没有大家就没有现在的 Swow。
[](https://github.com/swow/swow/graphs/contributors)
## 💬 开发 & 讨论
- **文档**：[https://docs.toast.run/swow/chs](https://docs.toast.run/swow/chs)
- **博客** [https://docs.toast.run/swow-blog/chs](https://docs.toast.run/swow-blog/chs)
- **能力项** [https://docs.toast.run/swow-blog/chs/init.html](https://docs.toast.run/swow-blog/chs/init.html)
- **API参考**：[https://docs.toast.run/swow-api/ci.html](https://docs.toast.run/swow-api/ci.html)
- **讨论区**：[https://github.com/swow/swow/discussions](https://github.com/swow/swow/discussions)
- **计划列表**：[https://github.com/swow/swow/projects](https://github.com/swow/swow/projects)
## 📃 开源协议
Swow 使用 [Apache License Version 2.0](http://www.apache.org/licenses/LICENSE-2.0.html) 开源。
Swow 也包含了一些第三方库，这些库的开源协议各不相同，请参考 [LICENSES.full](LICENSES.full) 获取完整的开源协议文本。
[license-badge]: https://img.shields.io/badge/license-apache2-blue.svg
[license-link]: LICENSE
[ci-badge]: https://github.com/swow/swow/workflows/tests/badge.svg
[ci-link]: https://github.com/swow/swow/actions?query=workflow:tests
[codecov-badge]: https://codecov.io/gh/swow/swow/branch/develop/graph/badge.svg
[codecov-link]: https://codecov.io/gh/swow/swow
[release-badge]: https://img.shields.io/github/release/swow/swow.svg?style=flat-square
[release-link]: https://github.com/swow/swow/releases
[made-with-love-badge]: https://img.shields.io/badge/made%20with-%E2%9D%A4-f00
[supported-php-versions-badge]: https://img.shields.io/badge/php-8.0--8.3-royalblue.svg
[supported-platforms-badge]: https://img.shields.io/badge/platform-Win32%20|%20GNU/Linux%20|%20macOS%20|%20FreeBSD%20-gold
[supported-architectures-badge]: https://img.shields.io/badge/architecture-x86--64%20|%20ARM64%20|%20mips64el%20|%20riscv64%20-maroon