PHPackages                             lartrix/lartrix - 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. [Admin Panels](/categories/admin)
4. /
5. lartrix/lartrix

ActiveLibrary[Admin Panels](/categories/admin)

lartrix/lartrix
===============

Laravel 后台管理包，为 trix 前端提供 API 接口

1.0.67(yesterday)141MITPHPPHP ^8.1CI passing

Since Jan 26Pushed 3w agoCompare

[ Source](https://github.com/maliang/lartrix)[ Packagist](https://packagist.org/packages/lartrix/lartrix)[ RSS](/packages/lartrix-lartrix/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (56)Versions (67)Used By (0)

Lartrix
=======

[](#lartrix)

Laravel 后台管理包，为 [Trix](https://github.com/maliang/trix) 前端提供 API 接口。

特性
--

[](#特性)

- 🔐 用户认证与权限管理（基于 Laravel Sanctum + Spatie Permission）
- 👥 用户、角色、权限管理
- 📋 菜单管理（支持树形结构）
- ⚙️ 系统设置
- 📦 模块化开发支持（基于 nwidart/laravel-modules）
- 🎨 PHP Schema Builder - 用 PHP 构建前端界面

环境要求
----

[](#环境要求)

- PHP >= 8.1
- Laravel >= 10.0

安装
--

[](#安装)

```
composer require lartrix/lartrix
```

运行安装命令：

```
php artisan lartrix:install
```

安装过程会：

1. 发布前端资源到 `public/admin`
2. 发布配置文件和迁移文件
3. 执行数据库迁移
4. 创建超级管理员角色和权限
5. 创建默认菜单
6. 交互式创建管理员账户
7. 创建 AI 开发指南文件（AGENTS.md、CLAUDE.md）

访问后台
----

[](#访问后台)

安装完成后访问 `/admin/` 进入后台管理系统。

配置
--

[](#配置)

配置文件位于 `config/lartrix.php`：

```
return [
    'route_prefix' => 'api/admin',      // API 路由前缀
    'guard' => 'sanctum',               // 认证守卫
    'super_admin_role' => 'super-admin', // 超级管理员角色名
    'models' => [...],                  // 模型类映射
    'controllers' => [...],             // 控制器类映射
];
```

### 多语言

[](#多语言)

Lartrix 与 Thinkrix 对前端提供相同的语言配置结构，以及 `/translations`、`/locale` 接口。Laravel 版内部使用 Laravel Translator 和 Nwidart 模块语言 namespace。

增加语言时，在 `config/lartrix.php` 声明：

```
'languages' => [
    'zh-CN' => ['label' => '中文', 'file' => 'zh-CN', 'naive_locale' => 'zh-CN'],
    'en-US' => ['label' => 'English', 'file' => 'en-US', 'naive_locale' => 'en-US'],
    'ja-JP' => ['label' => '日本語', 'file' => 'ja-JP', 'naive_locale' => 'en-US'],
],
```

项目覆盖或新增的完整界面语言包放在 `lang/vendor/lartrix/ja-JP.php`。前端会动态加载，无需增加 Trix 语言模块或重新构建前端。

Nwidart 模块继续使用原生目录和 namespace，例如：

```
Modules/Blog/Resources/lang/ja-JP/messages.php

```

模块 PHP 中使用 `__('blog::messages.title')`。Lartrix 的前端翻译目录会同时暴露为 `blog.messages.title`。通过 Nwidart 发布到 `resources/lang/modules/blog` 的项目覆盖优先级更高。旧版模块的 `Resources/lang/ja-JP.php` 汇总文件仍受兼容支持。

开发指南
----

[](#开发指南)

### 模块化开发

[](#模块化开发)

推荐使用 `nwidart/laravel-modules` 进行模块化开发：

```
php artisan module:make Blog
```

### 控制器开发

[](#控制器开发)

继承 `CrudController` 快速实现 CRUD：

```