shen/satoken

Sa-Token for PHP: auth, permission, annotation guard, jwt/temp-token/sign/apikey

v0.1.0 2026-03-18 15:35 UTC

Requires

• php: ^8.2
• firebase/php-jwt: ^6.11

Requires (Dev)

• phpunit/phpunit: ^11.5

Apache-2.0

• annotation
• auth
• permission
• rbac
• jwt
• satoken

README

Sa-Token 的 PHP 复刻版（Composer 包形式）。

原版项目说明

• 原版（Java）仓库：https://github.com/dromara/Sa-Token
• 本项目是对原版能力域的 PHP 复刻实现，不是原作者官方发布。

风险声明

• 本项目主要由 AI 编写与迁移，虽然已有自动化测试覆盖，但可能存在边界行为不稳定或与原版细节不一致。
• 用于生产环境前，请结合你的业务进行完整回归测试与灰度验证。

当前复刻范围

• 登录认证、会话管理（Account/Token Session）
• 权限/角色鉴权、多账号体系
• 封禁、踢下线、二级认证（safe）
• 注解鉴权（PHP 8 Attributes + DocBlock）
• Router/Filter
• JWT、TempToken、Sign、ApiKey
• Http Basic / Digest
• OAuth2（授权码/密码/客户端凭证/隐式/刷新）
• SSO（Ticket + Sign）

详细完整性评估见：

• docs/REPLICA_PROGRESS.md

安装

composer require shen/satoken

使用文档

• docs/USAGE.md

CI（GitHub Actions）

已提供自动测试工作流：

• .github/workflows/phpunit.yml

触发条件：push / pull_request 到 main，以及手动触发。

本地测试

composer test

当前结果：18 tests, 47 assertions, all passed。