PHPackages                             tsaotai/tsaotai-addons - 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. tsaotai/tsaotai-addons

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

tsaotai/tsaotai-addons
======================

TsaoTai plugin system for ThinkPHP 8

2026.1.7(1w ago)134↑164.7%Apache-2.0PHPPHP >=8.0.0

Since May 2Pushed 1w agoCompare

[ Source](https://github.com/tsaotai/tsaotai-addons)[ Packagist](https://packagist.org/packages/tsaotai/tsaotai-addons)[ Docs](https://github.com/tsaotai/tsaotai-addons)[ RSS](/packages/tsaotai-tsaotai-addons/feed)WikiDiscussions main Synced 1w ago

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

TsaoTai Addons
==============

[](#tsaotai-addons)

> 基于 ThinkPHP 8 的插件化管理系统

项目简介
----

[](#项目简介)

TsaoTai Addons 是一个专门为 ThinkPHP 8 设计的插件系统，提供完整的插件开发、管理和运行支持。支持自动加载插件、路由注册、配置管理等功能，让插件开发更加简单高效。

技术栈
---

[](#技术栈)

分类技术说明框架ThinkPHP 8核心框架PHP>= 8.0.0PHP 版本要求缓存ThinkPHP Cache（可选）插件列表缓存日志ThinkPHP Log（可选）异常日志记录插件Composer插件化管理系统架构
----

[](#系统架构)

```
tsaotai-addons/
├── src/                    # 核心源码
│   ├── Addons.php         # 插件管理器
│   ├── Loader.php         # 插件加载器
│   ├── Router.php         # 路由注册器
│   ├── Generator.php      # 插件生成器
│   ├── AddonDiscovery.php # 插件发现服务
│   ├── BaseController.php # 基础控制器
│   ├── PluginController.php # 插件管理控制器
│   ├── Config.php         # 配置管理
│   ├── Service.php        # 服务提供者
│   ├── command/           # 命令行工具
│   └ facade/              # Facade 支持
│   └ helper.php           # 助手函数
│
├── config.php             # 默认配置
├── composer.json          # 包配置
├── CHANGELOG.md           # 更新日志
├── README.md              # 说明文档
└── AI-DEVELOPMENT-GUIDE.md # AI 开发指南

```

核心特性
----

[](#核心特性)

- ✅ **自动加载**：安装后自动加载插件和路由，无需额外配置
- ✅ **插件生成器**：命令行快速创建插件，支持多种可选目录
- ✅ **缓存机制**：可选的插件列表和配置缓存，提升性能
- ✅ **异常处理**：单个插件失败不影响其他插件
- ✅ **向后兼容**：保留旧版本控制器，确保旧插件正常运行
- ✅ **规范开发**：标准化插件开发模板和目录结构

安装
--

[](#安装)

```
composer require tsaotai/tsaotai-addons
```

安装后，包会通过 ThinkPHP 服务提供者自动加载插件和路由，无需额外配置！

快速创建插件
------

[](#快速创建插件)

### 命令行方式（推荐）

[](#命令行方式推荐)

支持 3 种命令：

```
php think addon:make demo
php think plugin:make demo
php think make:addon demo
```

**创建带完整信息的插件：**

```
php think addon:make demo --title="示例插件" --description="这是一个示例插件" --author="教员" --plugin-version="2026.1.1"
```

**创建包含可选目录的插件：**

```
php think addon:make demo --with-model --with-validate --with-public
```

### 命令选项说明

[](#命令选项说明)

选项说明`--title`插件标题`--description`插件描述`--author`插件作者`--plugin-version`插件版本`--with-model`创建 model 目录`--with-validate`创建 validate 目录`--with-public`创建 public 目录`--with-base`创建插件自己的 Base 控制器（默认启用）`--with-config`创建 `config.php` 插件配置文件`--with-common`创建 `common.php` 公共函数文件`--with-service`创建 `service.php` 服务文件`--with-provider`创建 `provider.php` 服务提供者`--with-event`创建 `event.php` 事件配置`--with-middleware`创建 `middleware.php` 中间件配置插件目录结构
------

[](#插件目录结构)

```
addons/
└── demo/                    # 插件目录（唯一标识）
    ├── controller/          # 控制器
    │   ├── Base.php         # 基础控制器
    │   ├── Demo.php         # 主控制器
    │   └── Plugin.php       # 插件管理控制器
    ├── view/                # 视图文件
    │   ├── demo/            # 插件视图
    │   └── plugin/          # 管理视图
    ├── data/                # 数据文件
    │   └── plugin/
    │       ├── readme.md
    │       ├── rule.md
    │       └── update.md
    ├── route.php            # 插件路由
    ├── plugin.php           # 插件配置（必填）
    ├── README.md            # 插件说明
    └── .gitignore           # Git 忽略文件

```

插件配置说明
------

[](#插件配置说明)

`plugin.php` 是插件的核心配置文件：

```