SZ-Rust Core — 主框架包
对标 ThinkPHP 8 的 Rust Web 框架核心,基于 axum 0.8 + SZ-ORM。
模块结构
所有模块均已实现并通过测试。addons 重导出 sz-rust-addons-loader,
macros 重导出 sz-rust-macros 的过程宏。
| 模块 | 对齐 PHP | 状态 |
|---|---|---|
controller |
app\SzController / app\BaseController |
✅ |
model |
think\Model |
✅ |
schema_cache |
think\db\Fetch 字段缓存(SchemaCache + TableSchema + ColumnDefinition) |
✅ |
relation |
think\Model 关联关系(HasMany/BelongsTo/HasOne/BelongsToMany/Morph) |
✅ |
request |
$this->request->post/get |
✅ |
response |
renderJson/renderSuccess/renderError |
✅ |
middleware |
CORS/Auth/Log/RateLimit/Trace | ✅ |
guard |
NestJS Guard + Spring Security(sz-rust 自研) | ✅ |
hooks |
think-orm Model 钩子(HookDispatcher 16 事件) | ✅ |
multi_app |
auto_multi_app |
✅ |
health |
健康检查端点(K8s liveness/readiness) | ✅ |
static_files |
静态文件路由(tower-http::ServeDir) |
✅ |
error_handler |
404/500 标准化 JSON 响应 | ✅ |
h2 |
HTTP/2 + TLS(think-swoole SSL) |
✅ |
routing |
三层路由机制(属性宏/配置式/约定式) | ✅ |
addons |
addons/ 插件 |
✅ 重导出 sz-rust-addons-loader |
router |
with_route |
✅ |
container |
app() 容器 |
✅ |
error |
BaseException |
✅ |
macros |
compact() |
✅ 重导出 sz-rust-macros |
config |
config/app.php / database.php |
✅ |
log |
think-logger |
✅ |
server |
think-swoole / think-worker 启动入口 |
✅ |
validate |
think\Validate 数据验证器 |
✅ |
upload |
think\File + think\file\UploadedFile 文件上传 |
✅ |
cache |
think\facade\Cache 缓存 facade |
✅ |
session |
think\facade\Session 会话管理(SessionStore trait + MemorySessionStore) |
✅ |
cookie |
think\Cookie Cookie 管理(CookieJar + CookieOptions) |
✅ |
event |
think\Event 事件系统(Listener/Subscriber/Observer) |
✅ |
env |
think\facade\Env 环境变量管理 |
✅ |
i18n |
think\facade\Lang 多语言国际化 |
✅ |
mail |
think\facade\Mail 邮件抽象(Mailer trait + MemoryMailer) |
✅ |
notify |
think\facade\Notify 通知抽象(Notifier trait + MemoryNotifier + SlackNotifier) |
✅ |
oauth |
Laravel Socialite OAuth2 客户端(OAuth2Provider trait + GenericOAuth2Provider) | ✅ |
pay |
yansongda/pay 支付聚合(PayProvider trait + MemoryPayProvider + PayHttpTransport) |
✅ |
migration_history |
think migrate 迁移历史表(多方言 DDL + CRUD SQL 生成) |
✅ |
api_version |
API 版本管理(URL/Header/Query 多策略协商) | ✅ |
cache_warmer |
缓存预热管道(部署/启动时预热,串行/并行+超时控制) | ✅ |
debug_page |
Whoops-style 调试页(开发环境 HTML + 生产环境简洁页) | ✅ |
openapi |
OpenAPI 3.0.3 规范构建器 + Swagger UI / Redoc 渲染 | ✅ |
qr_code |
endroid/qr-code 二维码生成(PNG/SVG/矩阵) |
✅ |
wechat |
overtrue/wechat / EasyWeChat 微信 SDK(公众号/小程序/开放平台/企业微信) |
✅ |
gateway |
GatewayWorker\Gateway WebSocket 客户端管理(Gateway API 抽象 + GatewayTransport trait + MemoryGatewayTransport) |
✅ |