PHPackages                             toohamster/fleaphp-ex - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. toohamster/fleaphp-ex

ActiveLibrary[Framework](/categories/framework)

toohamster/fleaphp-ex
=====================

FLEA - Lightweight PHP MVC Framework with PSR compliance, RESTful routing, middleware pipeline, JWT authentication, and RBAC support

v2.2.1(2mo ago)01[1 issues](https://github.com/toohamster/fleaphp-ex/issues)MITPHPPHP >=7.4CI passing

Since Feb 25Pushed 2mo agoCompare

[ Source](https://github.com/toohamster/fleaphp-ex)[ Packagist](https://packagist.org/packages/toohamster/fleaphp-ex)[ RSS](/packages/toohamster-fleaphp-ex/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (5)Versions (16)Used By (0)

FleaPHP v2.0
============

[](#fleaphp-v20)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![PHP 7.4+](https://camo.githubusercontent.com/42c29faf1ca6eeb90bb12e28337987328494b4f61ade5197d9e087f45a28d31f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e342b2d626c75652e737667)](https://www.php.net/)

轻量级 PHP MVC 框架，采用 PSR 标准，支持 Router、Middleware、JWT 认证和 Context 上下文管理。

---

特性
--

[](#特性)

- **PSR 标准**：PSR-11 容器、PSR-16 缓存、PSR-3 日志
- **MVC 架构**：清晰的模型 - 视图 - 控制器分离
- **路由器**：RESTful 路由、路由分组、命名路由
- **中间件**：洋葱模型管道，支持 CORS/认证/限流
- **JWT 认证**：HS256 签名，支持 Token 刷新
- **Context 上下文**：可插拔的状态管理（Session/Redis/File/Database）
- **TableDataGateway**：简洁的数据库 CRUD 和关联查询
- **RBAC/ACL**：基于角色的权限控制和访问控制列表

---

快速开始
----

[](#快速开始)

### 方式一：通过 Composer 安装

[](#方式一通过-composer-安装)

```
composer require toohamster/fleaphp-ex
```

### 方式二：克隆项目

[](#方式二克隆项目)

```
git clone https://github.com/toohamster/fleaphp-ex.git
cd fleaphp-ex
```

### 安装依赖

[](#安装依赖)

```
php74 ~/bin/composer.phar install
```

### 3. 配置环境变量

[](#3-配置环境变量)

```
# 复制示例配置
cp demo/.env.example demo/.env

# 编辑 demo/.env 配置数据库等信息
```

### 4. 初始化数据库

[](#4-初始化数据库)

```
mysql -u root -p set('user_id', 123);

// 读取数据
$user_id = flea_context()->get('user_id');

// 检查键是否存在
if (flea_context()->has('user_id')) {
    // ...
}
```

### JWT 认证

[](#jwt-认证)

```
use FLEA\Auth\Jwt;

// 签发 Token
$token = Jwt::encode(['user_id' => 123], 7200);

// 验证 Token
$payload = Jwt::decode($token);

// 验证有效性
if (Jwt::verify($token)) {
    // Token 有效
}
```

---

配置说明
----

[](#配置说明)

### 数据库配置（.env）

[](#数据库配置env)

```
DB_DRIVER=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=your_password
DB_DATABASE=blog
```

### Context 配置

[](#context-配置)

```
# 驱动：session/redis/file/database
CONTEXT_DRIVER=session

# 身份标识：session/jwt/api-key/request-id
CONTEXT_IDENTITY=session
```

### JWT 配置

[](#jwt-配置)

```
JWT_SECRET=your-secret-key
JWT_TTL=7200
```

---

环境要求
----

[](#环境要求)

- **PHP**: 7.4+
- **Composer**: 依赖管理
- **数据库**: MySQL 5.0+ 或 PDO 支持的其他数据库

---

文档
--

[](#文档)

文档说明[SPEC.md](SPEC.md)框架规格说明书[USER\_GUIDE.md](USER_GUIDE.md)用户手册[demo/APP\_USAGE\_GUIDE.md](demo/APP_USAGE_GUIDE.md)博客应用使用手册[demo/BLOG\_SETUP.md](demo/BLOG_SETUP.md)博客安装指南[CHANGES.md](CHANGES.md)框架修改记录---

许可证
---

[](#许可证)

本项目采用 [MIT 许可证](LICENSE) 开源。

**注意**：框架代码采用 MIT 许可，但 `docs-book/` 目录下的图书项目版权归作者所有，未经许可不得用于商业出版。

---

作者
--

[](#作者)

FleaPHP 框架团队

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance84

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 76.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

11

Last Release

83d ago

Major Versions

v0.2.5 → v2.0.02026-03-29

PHP version history (2 changes)v0.1.0PHP >=7.0

v0.2.4PHP >=7.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16458414?v=4)[Hamster.Xu](/maintainers/toohamster)[@toohamster](https://github.com/toohamster)

---

Top Contributors

[![vb2005xu](https://avatars.githubusercontent.com/u/1505221?v=4)](https://github.com/vb2005xu "vb2005xu (157 commits)")[![toohamster](https://avatars.githubusercontent.com/u/16458414?v=4)](https://github.com/toohamster "toohamster (45 commits)")[![yushi5344](https://avatars.githubusercontent.com/u/24642463?v=4)](https://github.com/yushi5344 "yushi5344 (4 commits)")

---

Tags

jwt-authenticationphprbac-authorizationrestfulrestful-apipsr-3phpjwtmiddlewarePSR-11frameworkrouterormpsr-16rbacmvclightweightrestful

### Embed Badge

![Health badge](/badges/toohamster-fleaphp-ex/health.svg)

```
[![Health](https://phpackages.com/badges/toohamster-fleaphp-ex/health.svg)](https://phpackages.com/packages/toohamster-fleaphp-ex)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k532.1M19.4k](/packages/laravel-framework)[cakephp/cakephp

The CakePHP framework

8.8k19.1M1.7k](/packages/cakephp-cakephp)[symfony/symfony

The Symfony PHP framework

31.4k86.9M2.2k](/packages/symfony-symfony)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[phalcon/phalcon

Phalcon Framework

2461.6k1](/packages/phalcon-phalcon)[zemit-cms/core

Build Phalcon REST APIs faster with database-first scaffolding, model relationships, eager loading, identity, permissions, CLI, and WebSocket support.

138.5k1](/packages/zemit-cms-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)