PHPackages                             rice/basic - 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. [Utility & Helpers](/categories/utility)
4. /
5. rice/basic

ActiveLibrary[Utility & Helpers](/categories/utility)

rice/basic
==========

basic tool

v1.2.0(8mo ago)10652Apache-2.0PHPPHP >=7.4CI passing

Since Mar 14Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/rice-code/basic)[ Packagist](https://packagist.org/packages/rice/basic)[ RSS](/packages/rice-basic/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (7)Versions (8)Used By (0)

[![image](./doc/imgs/rice_basic.png)](./doc/imgs/rice_basic.png)

[![License](https://camo.githubusercontent.com/b3dd5777bf0d89dc72a2045cbf476c7bcdab389bd0ad40aeb339da333c3a2265/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d417061636865253230322d3445423142412e737667)](https://www.apache.org/licenses/LICENSE-2.0.html)[![github star](https://camo.githubusercontent.com/6e36e7c644225785a01247d76c46e4a0dc75bd0b8e4608c118dc3498ba854097/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f646d662d636f64652f62617369632e737667)](https://camo.githubusercontent.com/6e36e7c644225785a01247d76c46e4a0dc75bd0b8e4608c118dc3498ba854097/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f646d662d636f64652f62617369632e737667)[![github fork](https://camo.githubusercontent.com/84f1911259b2468ce73df9aa5a439d6fc0d6de1a3e0c5550cc249026147b4024/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f646d662d636f64652f62617369632e737667)](https://camo.githubusercontent.com/84f1911259b2468ce73df9aa5a439d6fc0d6de1a3e0c5550cc249026147b4024/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f646d662d636f64652f62617369632e737667)[![Tests](https://github.com/rice-code/basic/actions/workflows/tests.yml/badge.svg)](https://github.com/rice-code/basic/actions/workflows/tests.yml)

Rice Basic
==========

[](#rice-basic)

一个功能完善、结构清晰的 PHP 基础工具包，提供了丰富的组件和工具类，帮助开发者快速构建高质量的 PHP 应用。

特性
--

[](#特性)

- **基础框架组件**：提供 DTO、Entity、Enum、Exception 等核心组件
- **参数自动填充**：简化对象属性赋值，提高开发效率
- **数据访问与转换**：提供强大的类型转换和数据提取工具
- **日志系统**：支持带追踪ID的日志记录和多环境适配
- **异常处理**：完善的异常体系和观察者模式实现
- **国际化支持**：内置多语言处理能力
- **单例模式**：线程安全的单例实现
- **性能优化**：包含性能监控和优化工具
- **契约式编程**：定义清晰的接口规范

安装
--

[](#安装)

```
composer require rice/basic
```

目录结构
----

[](#目录结构)

```
├── src/
│   ├── Components/       # 核心组件
│   │   ├── Assembler/    # 数据装配器
│   │   ├── DTO/          # 数据传输对象
│   │   ├── Entity/       # 业务实体
│   │   ├── Enum/         # 枚举类
│   │   ├── Exception/    # 异常类
│   │   └── VO/           # 值对象
│   ├── Contracts/        # 接口定义
│   └── Support/          # 支持工具类
│       ├── Abstracts/    # 抽象类
│       ├── Annotation/   # 注解处理
│       ├── Converts/     # 转换器
│       ├── Loggers/      # 日志实现
│       ├── Observers/    # 观察者
│       ├── Properties/   # 属性处理
│       ├── Traits/       # 特性集合
│       └── Utils/        # 工具函数
├── tests/                # 测试代码
├── doc/                  # 文档
└── storage/              # 存储目录
    └── logs/             # 日志文件

```

核心组件
----

[](#核心组件)

### 框架组件关系

[](#框架组件关系)

[![继承对象关系图解](./doc/imgs/base_relation.png)](./doc/imgs/base_relation.png)

### DTO (数据传输对象)

[](#dto-数据传输对象)

数据传输层对象，主要继承 `BaseDTO` 类。用于聚合业务层中的多个参数变量，使代码更加整洁，参数变量更加直观。

**特点**：

- 采用失血模型，主要用于数据传输
- 提供属性访问器和修改器
- 支持参数自动填充

**示例**：

```