yooer/easyswoole

An efficient swoole framework

3.7.9 2026-03-14 12:44 UTC

Requires

• php: >=8.1
• ext-ctype: *
• ext-json: *
• ext-mbstring: *
• ext-swoole: >=4.4.4
• easy-swoole-php/orm: 1.5.5
• easyapi/validate: ^1.0
• easyswoole/crontab: 1.0.6
• easyswoole/easyswoole: 3.7.1
• easyswoole/file-watcher: dev-master
• easyswoole/http: 3.1.2
• easyswoole/http-annotation: 3.2.13
• easyswoole/http-client: 1.6.1
• easyswoole/i18n: 1.0.0
• easyswoole/jwt: 2.0.1
• easyswoole/mysqli: 4.0.9
• easyswoole/queue: 4.8.12
• easyswoole/redis: 2.0.4
• easyswoole/redis-pool: 3.0.3
• easyswoole/socket: 1.3.1
• easyswoole/task: 2.0.2
• easyswoole/verifycode: 3.1.2
• guzzlehttp/guzzle: ^7.0
• league/plates: 3.*
• mongodb/mongodb: ^2.
• phpmailer/phpmailer: ^6.9.1
• psr/container: 2.0.2
• ramsey/uuid: ^4.0
• voku/anti-xss: ^4

Requires (Dev)

• easyswoole/phpunit: ^1.1
• swoole/ide-helper: ^5.1

Apache-2.0

• XueSi

• framework
• php
• async
• swoole
• easyswoole

README

中文

更新部分功能

原版代码在这里，在 XueSiLf/easyswoole-docker 作者比较忙，框架中有几个Bug，修改了几个文件

• EasySwooleLib\Helper\Functions.php 修改了 response 方法
• EasySwooleLib\Response\Response.php
• EasySwooleLib\Request\Request.php

其他文件没有修改(移除了一些无用的配置文件 比如docker的)!

最近项目重构与功能更新 (2026-03-13)

1. 架构调整与核心 Helper

• **FastCache **: 并迁移至 App/Helper/FastCache.php，作为全局共享内存缓存。
• MongoDB 封装: MongoDbHelper 与 MongoDbPool 迁移至 App/Helper 目录。
• 全局初始化: FastCache 与 Mongo 服务已在 GlobalEvent.php 中配置为服务启动时自动初始化。
• 便捷函数: 在 App/Helper/Functions.php 中新增了全局 Helper 函数：
  • cache(): 获取 FastCache 实例。
  • mongo(): 获取 MongoDbHelper 实例。

2. 新增工具类 (App/Utility)

• PlatesRender.php: 集成 league/plates 模板引擎，支持灵活的视图渲染。
• SendMail.php: 基于 PHPMailer 的 SMTP 邮件发送工具，支持 HTML 格式。
• Telegram.php: 支持富文本、图片、媒体组及内联键盘的 Telegram Bot 推送工具。

3. 环境与配置

• 新增配置项模板：
  • Config/cache.php: 缓存配置。
  • Config/mongo.php: MongoDB 连接池。
  • Config/smtp.php: 邮件服务器设置。
  • Config/telegram.php: 机器人 Token 与频道 ID。

4. 依赖更新

• 执行了 composer update，新增了 mongodb/mongodb、phpmailer/phpmailer、guzzlehttp/guzzle、league/plates 等必要依赖。

骨架介绍

这是一个使用 EasySwoole 框架搭建的骨架应用程序。这个骨架让开发者更容易使用 EasySwoole 框架。该应用程序旨在作为那些希望熟悉 EasySwoole 框架的人的起点。

安装要求

EasySwoole 对系统环境有一些要求，只能在 Linux 和 Mac 环境下运行，但由于 Docker 虚拟化技术的发展，在 Windows 下 Docker for Windows 也可以作为运行环境。

各个版本的 Dockerfile 在 XueSiLf/easyswoole-docker 项目中已经给你准备好了，或者直接基于 EasySwoole 官方已经构建的 easyswoolexuesi2021/easyswoole 镜像来运行。

当你不想使用 Docker 作为运行环境时，你需要确保你的运行环境满足以下要求：

• PHP >= 7.4
• Swoole PHP 扩展 >= 4.4.23 且 Swoole PHP 扩展 <= 4.4.26
• JSON PHP 扩展
• Pcntl PHP 扩展
• OpenSSL PHP 扩展（如果需要使用 HTTPS）

使用 Composer 安装

创建新 EasySwoole 项目的最简单方法是使用 Composer。 如果您尚未安装，请按照文档安装。

创建新的 EasySwoole 项目：

安装 3.7.x 版本

composer create-project yooer/easyswoole project_name

安装完显示PHPUnit依赖有问题，要解决这个问题，您需要使用以下命令更新 PHPUnit 到修复版本：

composer update phpunit/phpunit --with-dependencies

建议

• 建议您将骨架中部分文件中的项目名称重命名为您实际的项目名称，例如像 composer.json 和 docker-compose.yml 这样的文件。
• 查看 App/HttpController/Index.php 以查看 HTTP 入口点的示例。

请记住：您始终可以将此 README.md 文件的内容替换为适合您项目的内容描述。

联系我们

问题：https://github.com/easy-swoole/easyswoole/issues

加群请加微信：