ptadmin/admin

PTAdmin admin package for Laravel.

1.0.21 2026-04-20 10:20 UTC

Requires

• php: ^7.4 || ^8.0
• ext-curl: *
• ext-json: *
• laravel/framework: ^8.75
• ptadmin/addon: ^1.0.8
• ptadmin/easy: ^1.0.7

Requires (Dev)

• orchestra/testbench: ^6.44
• phpunit/phpunit: ^9.6

Apache-2.0

• Zane

README

ptadmin/admin 是 PTAdmin 后台管理内核包。

它负责提供后台认证、授权资源、角色授权、组织扩展能力、后台接口路由、中间件、初始化命令，以及对应的配置、迁移和语言包。ptadmin/addon 与 ptadmin/easy 已作为强依赖内置在包依赖中，安装 ptadmin/admin 后不需要再单独安装这两个包。

功能范围

• 后台登录与认证守卫
• 资源授权、角色授权、直接授权
• 租户、组织、部门扩展表结构
• 后台 API 路由与中间件注册
• 后台前端入口路由与运行时配置脚本
• 默认后台资源初始化
• 配置、迁移、语言包、前端静态资源发布

安装

composer require ptadmin/admin

发布与迁移

发布全部 PTAdmin 资源：

php artisan vendor:publish --tag=ptadmin --force

发布配置：

php artisan vendor:publish --tag=ptadmin-config --force

发布迁移：

php artisan vendor:publish --tag=ptadmin-migrations --force

发布后台前端静态资源：

php artisan vendor:publish --tag=ptadmin-assets --force

执行迁移：

php artisan migrate

前端入口

后台前端页面入口与接口入口已拆分：

• PTADMIN_WEB_PREFIX：后台页面入口，默认 admin
• PTADMIN_API_PREFIX：后台接口入口，默认 system

运行时配置脚本固定为：

/{PTADMIN_WEB_PREFIX}/ptconfig.js

初始化命令

初始化授权角色与资源：

php artisan admin:auth-bootstrap

初始化创始人账户与默认授权：

php artisan admin:init

测试

包内测试基于 orchestra/testbench，独立仓库中可直接执行：

composer install
composer test

目录结构

ptadmin/
├── composer.json
├── README.md
├── phpunit.xml.dist
├── config/
├── database/
├── lang/
├── routes/
├── src/
└── tests/