happyqu / laravel-admin

v2.0.0 2026-10-26 05:01 UTC

Requires

• php: ^8.1
• ext-dom: *
• ext-fileinfo: *
• laravel/framework: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• phpunit/phpunit: ^10.5|^11.0|^12.0

Suggests

• intervention/image: Required for image handling and manipulation (^2.7).
• maatwebsite/excel: Required for Excel exports (^3.1).
• matthiasmullie/minify: Required for the admin:minify command (^1.3).
• spatie/eloquent-sortable: Required for orderable grids.

Conflicts

• ichynul/iframe-tabs: *
• laravel-admin-ext/log-viewer: *

Replaces

• encore/laravel-admin: 1.8.19

MIT

• admin
• iframe
• laravel
• tabs

Published on Packagist.org on 2026-10-26 05:02 UTC

README

happyqu/laravel-admin 是一个 Laravel 后台管理包，内置 iframe 标签页、全局菜单和日志查看器。前端基于 AdminLTE 4、Bootstrap 5 和 jQuery，资源随包提供，无需 npm 构建。

环境要求

• PHP 8.1+，具体版本需满足所用 Laravel 的要求
• Laravel 10 / 11 / 12 / 13
• PHP 扩展：fileinfo、dom

安装

composer require happyqu/laravel-admin:^3.0

支持 Laravel 自动发现，无需手工注册服务提供者。

配置好数据库后执行：

php artisan vendor:publish --tag=laravel-admin-config
php artisan vendor:publish --tag=laravel-admin-lang
php artisan vendor:publish --tag=laravel-admin-migrations
php artisan vendor:publish --tag=laravel-admin-assets
php artisan admin:install

访问 /admin，初始账号和密码均为 admin，首次登录后请修改密码。

配置

配置文件为 config/admin.php。标签页默认开启，可通过 iframe_tabs.enable 关闭；全局菜单和主题可在 .env 中设置：

ADMIN_GLOBAL_NAVIGATION=true
ADMIN_THEME=blue
ADMIN_COLOR_MODE=light

日志查看器默认位于 /admin/logs，读取 storage/logs。图片处理、Excel 导出等可选功能的依赖见 composer.json 中的 suggest。

升级

3.0 包含前端不兼容变更，旧项目请先阅读 升级指南 和 更新记录。

更新资源：

php artisan vendor:publish --tag=laravel-admin-assets --force
php artisan optimize:clear

发布资源会覆盖同路径文件，请先备份自定义修改。

许可证

MIT。第三方组件版权见 THIRD_PARTY_NOTICES.md。