Download the PHP package lartrix/thinkrix without Composer

Lartrix Think (Thinkrix)

ThinkPHP 8 后台管理包，为 Trix 前端提供完整 API 接口

Thinkrix 是 Lartrix（Laravel 版）的 ThinkPHP 移植版，两者功能同步。前端统一使用 Trix（Vue 3 + NaiveUI + vschema-ui），后端生态共享。

模块生态协议

当前版本包含破坏性升级，旧 Registry 配置名和旧的独立 manifest 约定不再兼容：

• 模块仍使用根目录 module.json，但只有 module.json.trix 是 Trix 生态协议。name、providers、middleware 等顶层字段属于 ThinkPHP 模块运行时，不会被当作 Trix 清单字段解析。
• 模块市场配置统一位于 config/thinkrix.php 的 module_market 节点；市场 Auth Key 只使用环境变量 TRIX_AUTH_KEY，不再读取 THINKRIX_MODULE_REGISTRY_*、TRIX_REGISTRY_* 等旧名称。
• 项目安装计划只会原子写入 config/trix-project.php。根目录 trix-project.json 是项目发布清单，不是安装后的运行时配置。

项目安装先解析 Registry 安装计划并生成 config/trix-project.php；加上 --execute 后，才会依次下载、校验、暂存、复核并复制缺失模块：

安全边界是强制的：市场 HTTP 请求不跟随重定向；包下载地址必须与 module_market.url 的 scheme、host、port 同源；暂存、复制和更新替换前都会递归拒绝符号链接。Zip 预检还会拒绝目录穿越、绝对路径和 Windows 盘符路径，安装链路不会自动执行包内脚本。

模块接口按职责拆分：ModuleController 仅管理本地已安装模块及 Logo；ModuleMarketController 负责市场列表和模块/项目安装；ModulePublishController 负责模块与项目发布。宿主项目需要替换控制器时，应分别配置 controllers.module、controllers.module_market 和 controllers.module_publish。

完整说明见 模块开发与生态。

功能特性

• 用户管理 — 用户 CRUD、角色分配、状态管理、批量删除、Excel 导出
• 角色管理 — 角色 CRUD、权限分配、启用/禁用
• 权限管理 — 树形权限管理、按模块归组
• 菜单管理 — 树形菜单配置、JSON Schema 渲染、图标选择器
• 系统设置 — 标题/Logo/版权等站点配置
• 数据字典 — 字典分组/项管理，前端 Select 选项
• 通知中心 — 消息管理、已读/未读、轮询/WebSocket 实时推送
• 模块管理 — 文件系统模块发现、启停管理、模块市场
• 主题配置 — 亮/暗模式、主题色、布局模式等全量前端配置
• 实时消息 — 支持轮询(polling)和 WebSocket 两种模式，可配置开关和间隔
• 导航栏扩展 — 支持通过配置添加自定义图标按钮，或通过 schema_api 返回任意 UI
• Token 认证 — Bearer Token，支持多 guard 隔离、过期时间配置
• RBAC 权限 — 基于角色的访问控制，支持权限继承
• 二级后台 — 模块化开发，支持独立后台（如商户后台）
• 代码生成 — 模块脚手架命令，快速生成 CRUD

安装

环境要求

• PHP 8.1+
• ThinkPHP 8.0+
• MySQL 5.7+ / MariaDB 10.3+
• Composer 2.x

步骤

安装命令会自动执行迁移或兜底建表，并创建超级管理员角色、权限、默认菜单和系统设置。

配置

安装后配置文件位于 config/thinkrix.php，支持环境变量覆盖：

完整配置项参见 config/thinkrix.php。

增加语言

语言种类由 Thinkrix 后端配置提供，不需要修改或重新编译 Trix 前端。例如增加日语：

然后创建项目语言文件 config/lang/ja-jp.php。它可以同时包含后端 Schema 文案和 Trix 界面翻译；项目语言会覆盖包内同名键。切换语言后，前端会从 /translations 动态加载语言包并缓存，无需增加前端语言模块。

naive_locale 控制 Naive UI 日期、分页等内置文案的基础语言，目前支持 zh-CN 和 en-US；其他语言可以先选择其中一个作为回退。

命令参考

导航栏自定义

支持两种方式在右上角添加自定义按钮：

1. 简单图标按钮（配置即可）

2. 高级自定义（通过 schema API 返回任意 UI）

schema_api 接口返回 vschema-ui JSON 节点，支持 NaiveUI 所有组件（Popover、Dropdown、Switch 等）。

实时消息配置

启用后前端每 interval 毫秒调用 /notifications/poll?since_id=X 拉取增量消息。 开发者可继承 RealtimeService 重写 getNewMessages() / getUnreadCount() 实现自定义逻辑。

Schema Builder

通过 PHP 代码构建 JSON Schema，由前端 vschema-ui 渲染为 NaiveUI 组件。

示例：CRUD 页面

支持组件：120+ NaiveUI 组件封装 + 自定义业务组件（CrudPage、OptForm、DataTable 等）。

文件结构

与 Laravel 版的差异

Thinkrix 与 Lartrix（Laravel 版）功能同步，主要差异：

License

MIT