PHPackages                             viswoole/viswoole - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. viswoole/viswoole

ActiveProject[Framework](/categories/framework)

viswoole/viswoole
=================

viswoole是一个基于swoole扩展的高性能开发框架。

v1.0.1(1y ago)16MITPHPPHP >=8.3

Since Oct 7Pushed 1y agoCompare

[ Source](https://github.com/viswoole/viswoole)[ Packagist](https://packagist.org/packages/viswoole/viswoole)[ Docs](https://viswoole.com)[ RSS](/packages/viswoole-viswoole/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (5)Used By (0)

[![logo](/public/logo.png)](/public/logo.png)
一款基于[swoole](https://www.swoole.com/)开发的轻量级`PHP`框架

[![Gitee](https://camo.githubusercontent.com/0de3176b5e7fe0ea831898c6aa9f1cb43193737d50644b27c042f9842e59627c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f47697465652d626c75653f7374796c653d666c61742d737175617265266c6f676f3d4769746565)](https://gitee.com/viswoole/viswoole)[![GitHub Stars](https://camo.githubusercontent.com/ae9f3dd046eeb73d710946504726347e5b81d142560e19ff5c5dd801e1703998/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f766973776f6f6c652f766973776f6f6c653f7374796c653d666c61742d737175617265266c6f676f3d476974687562)](https://github.com/viswoole/viswoole)[![License](https://camo.githubusercontent.com/3e1839a5f4b4d6cf9092d8a5be5713339f73d4e30219b6c3377cd44f2a400a4a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d417061636865253230322e302d626c75653f7374796c653d666c61742d737175617265)](http://www.apache.org/licenses/LICENSE-2.0)

特性
--

[](#特性)

- **易用**：遵循PSR规范，学习成本低，注释与异常反馈信息均为中文，轻松阅读。
- **安全**：优雅地依赖注入方式，提供了参数基本类型校验，以及扩展规则校验，无需额外编写validate去校验请求参数是否正确，现在您只需要关注业务代码，让框架帮你完成参数校验。
- **性能**：基于`swoole`的协程，在性能上比`PHP`原生的`fpm`要快很多。
- **扩展**：框架的扩展性非常强，提供了服务发现、依赖下发、`swoole`服务事件HOOK等常用功能，能够依据这些功能拓展你自定义的服务。
- **文档**：框架提供了API文档结构生成功能，能够根据路由树自动生成API文档，文档结构中包含了请求参数结构、响应数据结构等构建API文档所需的信息。
- **异步任务**：框架内置了轻量的异步任务管理器，中小型项目开箱即用。

> 框架运行环境依赖于 `PHP`^8.3 + `swoole`^5.0

文档
--

[](#文档)

[Viswoole开发文档](https://viswoole.com)

### 安装

[](#安装)

```
composer create-project viswoole/viswoole myProject
```

### 启动服务

[](#启动服务)

```
# 进入项目目录
cd myProject
# 安装依赖
composer install
# http为服务名称，是可选的，不填写默认会读取config/server.php配置文件中的default_start_server
php viswoole start:server http -d # -d 参数代表后台启动
```

如需单独更新框架依赖，可以使用如下命令：

```
composer update viswoole/framework
```

### 重启服务

[](#重启服务)

```
# 如果不传入serverName，则会关闭所有在运行的服务
# 默认重启worker进程和task进程，可以选择传入 -t 参数重启task进程
# 除了 -t 参数以外，还接收一个 -f 参数，会先安全的停止服务再重启服务
php viswoole reload:server http
```

### 关闭服务

[](#关闭服务)

```
# 如果不传入serverName，则会关闭所有在运行的服务
php viswoole close:server http
```

### 热重载

[](#热重载)

内置了一个shell脚本`watch`，可以用来监听文件修改，实现热重载。

```
# 依赖 inotify-tools 工具，使用前请先安装该工具！
# sudo apt-get install inotify-tools
/bin/sh watch http # 唯一接收一个可选参数[serverName]
```

参与开发
----

[](#参与开发)

作者个人精力与能力有限，期待社区贡献，提交PR或Issue即可！

许可证书
----

[](#许可证书)

`Viswoole`遵循[Apache-2.0](LICENSE)开源协议。

后续计划
----

[](#后续计划)

如果有建议请提交issue。

- 基于`Vue`开发一套Admin管理系统UI框架，为可视化开发做好准备的同时，会将API文档Web界面补全。
- 微服务`RPC`支持，敬请期待。
- 视图模板解析引擎，后续会为`Viswoole`打造一些`vite`插件，用于支持`vue`，`react`等前端框架。

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance36

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

580d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c729c5af5f63ace5989e72cecb9d677b064873a4d4ed9ce46138ffff6b6e172c?d=identicon)[zhuchonglin](/maintainers/zhuchonglin)

---

Top Contributors

[![zhuchonglin](https://avatars.githubusercontent.com/u/79825675?v=4)](https://github.com/zhuchonglin "zhuchonglin (125 commits)")

---

Tags

frameworkviswoole

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/viswoole-viswoole/health.svg)

```
[![Health](https://phpackages.com/badges/viswoole-viswoole/health.svg)](https://phpackages.com/packages/viswoole-viswoole)
```

###  Alternatives

[hemp/presenter

Easy Model Presenters in Laravel

247592.6k1](/packages/hemp-presenter)[pestphp/pest-plugin-stressless

Stressless plugin for Pest

67792.6k16](/packages/pestphp-pest-plugin-stressless)[wpstarter/framework

The WpStarter Framework - Laravel Framework for WordPress

1810.1k4](/packages/wpstarter-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)