安装
版本信息
当前文档对应 Lartrix v1.x 版本。
环境要求
| 依赖 | 版本要求 |
|---|---|
| PHP | ^8.1 |
| Laravel | ^10.0 | ^11.0 | ^12.0 |
| Composer | 2.x |
依赖包：laravel/sanctum、spatie/laravel-permission、nwidart/laravel-modules。
安装步骤
1. 安装 Lartrix
bash
composer require lartrix/lartrix2. 运行安装命令
bash
php artisan lartrix:install安装命令会按序执行：
- 发布前端资源到
public/admin - 发布依赖包配置与迁移（spatie/sanctum/modules）
- 发布 Lartrix 配置文件（
config/lartrix.php） - 配置
config/auth.php（admin guard/provider） - 配置 composer merge-plugin（模块化开发）
- 运行数据库迁移
- 创建超级管理员角色与基础权限
- 初始化系统设置与默认菜单
- 创建超级管理员账户（交互式设置密码）
- 创建 AI 开发指南文件（AGENTS.md、CLAUDE.md）
3. 登录后台
默认管理员账号由安装过程交互式创建，用户名 admin，密码在安装时设置（默认示例 123456）。
bash
php artisan serve访问：http://localhost:8000/admin（路径由 config/lartrix.php 的 path 决定）
已有数据保护
lartrix:install检测到已有数据时会二次确认，取消则中止- 已存在的
config/lartrix.php默认不会被覆盖（保持用户自定义） - 需要显式覆盖配置时使用
--force：
bash
php artisan lartrix:install --force从旧版本升级时若需同步最新配置结构（如新增的
notification/realtime键），可执行php artisan vendor:publish --tag=lartrix-config --force后手动合并自定义项。
发布前端资源
前端资源更新后（或 public/admin 缺失时）重新发布：
bash
php artisan lartrix:publish-assets测试
bash
php -d extension=pdo_sqlite ./vendor/bin/phpunit测试套件使用 SQLite 内存库，需要 PHP 的 pdo_sqlite 扩展。