matedon / laravel-admin
为 Laravel PHP 框架提供的行政界面构建器,只需几行代码即可构建 CRUD 后端。
Requires
- php: >=5.6.4
- laravel/framework: 5.4.*
- symfony/dom-crawler: 3.1.*
Requires (Dev)
- fzaninotto/faker: ~1.4
- intervention/image: ~2.3
- laravel/browser-kit-testing: ^1.0
- laravel/laravel: 5.4.*
- phpunit/phpunit: ~5.0
- symfony/css-selector: 2.8.*|3.0.*
Suggests
- intervention/image: Required to handling and manipulation upload images (~2.3).
- spatie/eloquent-sortable: Required to built orderable gird.
This package is not auto-updated.
Last update: 2024-09-23 08:11:32 UTC
README
此项目基于 z-song/laravel-admin 的项目。
laravel-admin 是 Laravel PHP 框架的行政界面构建器,可以帮助您通过几行代码构建 CRUD 后端。
Z-song 管理员有 演示,使用 username/password:admin/admin。
受到 SleepingOwlAdmin 和 rapyd-laravel 的启发。
屏幕截图
安装
首先,安装 Laravel,并确保数据库连接设置正确。
Laravel 5.2
composer require matedon/laravel-admin "dev-master"
Laravel 5.3
composer require matedon/laravel-admin "1.3.x-dev"
Laravel 5.1
composer require matedon/laravel-admin "1.1.x-dev"
在 config/app.php 中添加 ServiceProvider
MAteDon\Admin\Providers\AdminServiceProvider::class
然后运行以下命令完成安装:
php artisan vendor:publish --tag=laravel-admin
php artisan admin:install
在浏览器中打开 https:///admin/,使用用户名 admin 和密码 admin 登录。
默认设置
在 config/admin.php 文件中包含一个设置数组,您可以在其中找到默认设置。
文档
目录结构
安装后,您可以在 app/Admin 目录中找到目录,然后我们的大部分开发工作都在此目录下进行。
app/Admin
├── Controllers
│ ├── ExampleController.php
│ └── HomeController.php
└── routes.php
app/Admin/routes.php 用于定义路由,更多详细信息请参阅 路由。
app/Admin/Controllers 目录用于存储所有控制器,此目录下的 HomeController.php 文件用于处理管理员的首页请求,ExampleController.php 文件是一个控制器示例。
快速入门
以 Laravel 自带的 users 表为例,表的结构如下
CREATE TABLE `users` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(255) COLLATE utf8_unicode_ci NOT NULL, `email` varchar(255) COLLATE utf8_unicode_ci NOT NULL, `password` varchar(60) COLLATE utf8_unicode_ci NOT NULL, `remember_token` varchar(100) COLLATE utf8_unicode_ci DEFAULT NULL, `created_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00', `updated_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00', PRIMARY KEY (`id`), UNIQUE KEY `users_email_unique` (`email`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci
此表的模型为 App\User.php
您可以按照以下步骤设置 users 表的 CURD 接口
1. 添加控制器
使用以下命令为 App\User 模型创建控制器
php artisan admin:make UserController --model=App\\User
上述命令将在 app/Admin/Controllers/UserController.php 中创建控制器。
2. 添加路由
在 app/Admin/routes.php 中添加路由:
$router->resource('users', UserController::class);
3. 添加左侧菜单项
打开 https://:8000/admin/auth/menu,添加菜单链接并刷新页面,然后在左侧菜单栏中找到链接项。
4. 构建网格和表单
其余的工作需要在 app/Admin/Controllers/UserController.php 中完成,找到 form() 和 grid() 方法,并使用 model-grid 和 model-form 编写几行代码,更多详细信息请参阅 模型网格 和 模型表单。
其他
laravel-admin 基于以下插件或服务
- Laravel
- AdminLTE
- Bootstrap Markdown
- 日期时间选择器
- CodeMirror
- font-awesome
- moment
- 谷歌地图
- 腾讯地图
- bootstrap-fileinput
- jquery-pjax
- Nestable
- noty
许可协议
laravel-admin 根据 MIT 许可协议 (MIT) 许可。
