README

Swige 是一个基于 Swoole 的高性能 PHP 框架，专为现代 Web 应用和微服务架构设计。

特性

• ⚡ 基于 Swoole 的高性能 HTTP 服务器
• 🧩 依赖注入容器 (PHP-DI)
• 📦 模块化设计
• 🌐 支持 PSR 标准 (PSR-7, PSR-11, PSR-3)
• 📚 完善的文档系统 (docsify)
• 🐳 Docker 开发环境支持
• 📊 内置监控和日志系统

快速开始

环境要求

• PHP 8.2+
• Swoole 6.0+
• Docker (可选，推荐开发环境使用)
• Composer 2.5+

安装

composer create-project jammiest/swige your-project-name

开发环境启动

# 一键启动所有服务
docker-compose up -d --build

# 或者使用开发环境配置
docker-compose -f docker-compose.dev.yml up -d --build

常用命令

# 启动服务器（开发模式）
docker-compose exec app php bin/console server:start

# 启动守护进程
docker-compose exec app php bin/console server:start --daemon

# 查看状态
docker-compose exec app php bin/console server:status

# 重启服务器
docker-compose exec app php bin/console server:restart

# 进入PHP容器
docker-compose exec app bash

# 查看实时日志
docker-compose logs -f app

# 运行单元测试
docker-compose exec app php vendor/bin/phpunit

# 生成代码覆盖率报告
docker-compose exec app php vendor/bin/phpunit --coverage-html reports/coverage

目录结构

.
├── app/                  # 应用代码
├── bootstrap/            # 框架启动文件
├── config/               # 配置文件
├── docsify/              # 文档系统
├── Helpers/              # 辅助函数
├── public/               # 公共资源
├── resources/            # 资源文件
├── storage/              # 存储目录
├── tests/                # 测试文件
├── vendor/               # Composer依赖
├── .env                  # 环境变量
├── composer.json         # Composer配置
└── docker-compose.yml    # Docker配置

文档

本地查看文档：

docsify serve docsify

在线文档：https://swige-docs.example.com

贡献

欢迎提交 Pull Request 或 Issue。

许可证

Swige 框架采用 MIT LICENSE.