PHPackages                             eternalphp/framework - 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. eternalphp/framework

ActiveLibrary[Framework](/categories/framework)

eternalphp/framework
====================

The eternalphp Framework.

v3.1.0(2mo ago)128MITPHPPHP >=5.6

Since Mar 24Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/eternalphp/framework)[ Packagist](https://packagist.org/packages/eternalphp/framework)[ RSS](/packages/eternalphp-framework/feed)WikiDiscussions master Synced 5d ago

READMEChangelogDependencies (2)Versions (36)Used By (0)

EternalPHP Framework
====================

[](#eternalphp-framework)

`eternalphp/framework` 是一个全栈的、轻量级的现代化 PHP Web 开发框架。它汲取了现代 PHP 框架的诸多优秀设计理念（如依赖注入容器、中间件、Pipeline、Eloquent ORM 等），同时依然保持了对 PHP 5.6+ 的兼容性，在轻量与现代化之间取得了良好的平衡。

系统要求
----

[](#系统要求)

- PHP >= 5.6
- [filp/whoops](https://github.com/filp/whoops) (错误提示组件)

核心特性
----

[](#核心特性)

本框架包含了一套完整的现代 Web 开发所需的组件库，主要特性包括：

- **依赖注入与容器 (Container / Foundation\\Application)**：提供了强大的反向控制（IoC）容器，支持自动绑定与单例管理。
- **灵活的路由系统 (Router)**：支持 RESTful 路由、路由分组、中间件挂载等高效的路由调度机制。
- **中间件与管道 (Middleware & Pipeline)**：基于 Pipeline 实现的请求处理流，方便在请求到达控制器前后进行拦截、过滤或处理（如鉴权、日志、请求修改等）。
- **对象关系映射 (Database / Eloquent)**：内置类似于 Laravel Eloquent 的强大 ORM 实现，支持模型关联（Relation）、数据库迁移以及 Schema 结构构建器。
- **事件机制 (Event)**：支持同步事件处理和异步事件系统，解耦业务逻辑。
- **缓存与 Redis 集成 (Cache & Redis)**：统一的缓存接口支持，轻松对接多级缓存及 Redis 数据操作。
- **请求与响应封装 (Http / Session / Cookie)**：提供了统一的 Request 和 Response 抽象对象，包含对 Session 及 Cookie 的便捷管理。
- **CLI 命令行支持 (Console)**：内置命令行工具体系，方便开发定时任务和维护脚本。
- **多语言化 (Language)**：原生支持 i18n 多语言环境。
- **助手函数 (Foundation\\functions.php)**：框架提供了一系列开箱即用的全局助手函数，比如：
    - `app()`, `application()`: 快速获取容器实例。
    - `config()`, `env()`: 配置信息的快速访问。
    - `request()`, `response()`, `success()`, `fail()`: 便捷的 HTTP 操作。
    - `html_in()`, `html_out()`, `sql_in()`: 内置的安全过滤机制，有效防范 XSS 及 SQL 注入。
    - `https_request()`: 全局 CURL 快捷调用方法。

安装说明
----

[](#安装说明)

通过 Composer 进行安装或在项目依赖中引入：

```
{
    "require": {
        "eternalphp/framework": "dev-master"
    }
}
```

执行：

```
composer install
```

目录结构介绍
------

[](#目录结构介绍)

框架的源码均位于 `src/framework` 中，主要模块如下：

```
src/framework/
├── Cache/         # 缓存服务
├── Config/        # 配置加载与管理
├── Console/       # CLI 命令行处理模块
├── Container/     # 核心 IoC 容器
├── Controller/    # 基础控制器基类
├── Cookie/        # Cookie 管理模块
├── Database/      # 数据库连接层、Schema构建器以及 Eloquent ORM 实现
├── Debug/         # 调试模式相关工具
├── Event/         # 事件调度器 (同步/异步)
├── Exception/     # 框架内部统一异常处理机制
├── Filesystem/    # 文件系统操作接口封装
├── Foundation/    # 框架核心应用生命周期模块 (如 Application.php, 核心助手函数)
├── Hashing/       # 数据哈希加密组件
├── Http/          # HTTP 请求、响应及上传处理封装
├── Language/      # 多语言本地化支持
├── Logger/        # 日志记录系统
├── Middleware/    # HTTP 中间件机制
├── Pipeline/      # 管道中间件调度实现
├── Redis/         # Redis 原生类支持
├── Router/        # 网络请求路由分发机制
├── Session/       # 会话控制服务
├── Support/       # 支持和助手类 (如 Collection、Str 辅助类)
├── Util/          # 通用工具类组件
├── Validate/      # 数据和表单校验规则引擎
└── View/          # 视图编译与渲染层

```

生命周期概览
------

[](#生命周期概览)

1. **实例化 Application 容器**：在入口文件中初始化 `framework\Foundation\Application` 实例。
2. **初始化框架环境 (init)**：加载配置（Config）、定义基础路径、绑定核心服务。
3. **HTTP 调度**：通过 `Router` 及 `Pipeline` 获取并执行匹配到的中间件链路（Middleware）。
4. **触发 Controller**：完成中间件调度后，实例化相应的 Controller ，执行业务逻辑。
5. **返回 Response**：通过规范的 Response 发送 HTTP 报文给客户端，并在周期末尾清理容器或触发终止事件。

ORM (Eloquent) 使用示例
-------------------

[](#orm-eloquent-使用示例)

框架内部实现了类似于 Laravel 的 `Eloquent ORM`，支持链式操作、自动分页、关联模型与事务处理。

### 1. 定义模型

[](#1-定义模型)

模型类通常需要继承 `framework\Database\Eloquent\Model`，你可以在其中指定表名或主键：

```
namespace app\Entity;

use framework\Database\Eloquent\Model;

class User extends Model
{
    // 指定关联的数据表（如果表名为 users，框架会自动推断，但显式指定更安全）
    protected $table = 'users';

    // 指定主键（默认为 id）
    protected $primaryKey = 'id';
}
```

### 2. 基础查询

[](#2-基础查询)

内置丰富的查询构造器方法，支持连贯操作：

```
use app\Entity\User;

// 根据主键查找当条数据
$user = User::first(1);

// 获取表内所有记录
$users = User::select();

// 条件查询与获取第一条结果
$adminUser = User::where('role', 'admin')->where('status', 1)->find();

// 链式查询与排序
$latestUsers = User::where('status', 1)
                    ->orderBy('created_at', 'DESC')
                    ->limit(10)
                    ->select();

// 获取总条数
$count = User::where('status', 1)->rows();

// 简单分页功能 (自动返回带分页的数据集)
$pageData = User::where('status', 1)->paginate(15);
```

### 3. 数据新增

[](#3-数据新增)

```
// 新增单条数据
$insertData = [
    'username' => 'testuser',
    'email'    => 'test@example.com',
    'status'   => 1
];
// 返回新增后的主键 ID
$userId = User::insert($insertData);
```

### 4. 数据更新

[](#4-数据更新)

```
// 条件更新
User::where('id', 1)->update([
    'status' => 0,
    'updated_at' => time()
]);
```

### 5. 数据删除

[](#5-数据删除)

```
// 条件删除
User::where('id', 1)->delete();
```

### 6. 事务操作

[](#6-事务操作)

使用事务来保证复杂写入的一致性：

```
$userModel = new User();

// 开启事务
$userModel->startTrans();

try {
    // 执行操作 1
    User::insert(['username' => 'user1']);
    // 执行操作 2
    User::where('id', 1)->update(['money' => ['+', 100]]);

    // 提交事务
    $userModel->commit();
} catch (\Exception $e) {
    // 出现异常则回滚
    $userModel->rollback();
}
```

### 7. 模型关联（Relations）

[](#7-模型关联relations)

框架支持常见的关联方法（`HasOne`, `HasMany`, `BelongsTo` 等等）。

```
class User extends Model
{
    // 一对多关联
    public function articles()
    {
        return $this->hasMany(Article::class, 'user_id', 'id');
    }
}

// 关联获取使用示例
$user = User::first(1);
// 获取其关联的文章对象或数组（根据实现细节可能会返回数据集）
$articles = $user['articles'];
// 或者作为方法添加附加条件
$articles = $user->articles()->where('status', 1)->select();
```

作者与协议
-----

[](#作者与协议)

- **Author**: yuanzhongyi ()
- **License**: 此框架在 MIT 协议下开源发行。

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance87

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 54.8% 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 ~66 days

Recently: every ~365 days

Total

34

Last Release

63d ago

Major Versions

v1.7.5 → v2.1.02022-02-22

v2.2.4 → v3.0.12024-01-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/b4c88fe31879730bff90d8469cfd48d8744b10e3f29ee166307d62ca6d03c9a3?d=identicon)[eternalphp](/maintainers/eternalphp)

---

Top Contributors

[![eternalphp](https://avatars.githubusercontent.com/u/13829842?v=4)](https://github.com/eternalphp "eternalphp (23 commits)")[![eternalYuan](https://avatars.githubusercontent.com/u/53560109?v=4)](https://github.com/eternalYuan "eternalYuan (19 commits)")

---

Tags

frameworketernalphp

### Embed Badge

![Health badge](/badges/eternalphp-framework/health.svg)

```
[![Health](https://phpackages.com/badges/eternalphp-framework/health.svg)](https://phpackages.com/packages/eternalphp-framework)
```

###  Alternatives

[themosis/theme

The Themosis framework boilerplate theme.

10449.0k3](/packages/themosis-theme)[bowphp/framework

The bow PHP Framework

6015.5k8](/packages/bowphp-framework)

PHPackages © 2026

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