一款基于swoole开发的轻量级PHP框架

特性

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

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

文档

Viswoole开发文档

安装

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开源协议。

后续计划

如果有建议请提交issue。

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