systeminc/laravel-admin

Laravel 框架的管理面板

v1.8.8 2021-02-12 12:04 UTC

README

Build Status StyleCI

这是 Laravel Admin,一个 CRUD(创建、读取、更新和删除)包,可以帮助您在几分钟内搭建管理面板。目前我们支持以下模块:

  • 页面(页面元素、子页面、图片、HTML 编辑器)
  • 图库(图片、更改顺序)
  • 博客(文章、评论)
  • 商店(产品、分类、评论、订单、库存)
  • 地点(位置、地图)
  • 线索(联系人、订阅)
  • 多个管理员

一旦您的管理面板搭建完成,您就可以轻松地将所有这些元素放置到您应用程序文件中的任何位置。有关使用说明,请参阅下面的 使用部分

支持 Laravel 5.2 -> 5.6 和 PHP 7+

. . . . . .

安装

使用 composer 安装

$ composer require systeminc/laravel-admin

在 Laravel 5.5 中,使用包自动发现,所有设置都应自动完成。对于 < 5.5,在 composer 安装包完成后,按照以下说明操作

将服务提供者添加到 config/app.php 中的 'providers' 数组中(Laravel 5.4 及以下版本)

SystemInc\LaravelAdmin\AdminServiceProvider::class,

如果您想将此包用作外观,请将以下行添加到 config/app.php 中的 $aliases 数组中。

'SLA' => SystemInc\LaravelAdmin\Facades\SLA::class,

运行以下安装命令开始安装包

$ php artisan laravel-admin:install

如果您想从头开始重新安装包,只需删除 config/laravel-admin.php 文件,删除数据库,然后再次运行安装命令。

如果我们包的更新抛出 composer 错误,请尝试使用以下命令手动更新依赖项

$ php artisan laravel-admin:update

注意,此安装使用迁移,因此您必须从可以访问您的数据库的机器上运行它。

例如,如果您使用 Vagrant,您必须首先运行 vagrant ssh,然后转到您的项目目录,并运行此安装命令。与运行标准 Laravel 迁移命令的方式相同。

扩展

  • 要扩展管理面板中的 订单项 视图,以便自定义并显示更多关于您的自定义业务模型的 订单项 的详细信息,请将 blade 模板 resources/view/sla/order/item.blade.php 添加到您的项目中。订单项 数据在 $orderItem 变量中可用。
  • 要扩展管理包的导航视图,请将 blade 添加到您的项目中 resources/view/sla/layout/navigation.blade.php。使用无序列表 <ul>
  • 要使用您自己的控制器扩展管理路由,请在 /routes/sla-routes.php 中创建新文件并指向您的控制器。这将位于选择的 prefix 下,并使用管理员的凭据进行保护。要使 view 保持相同的布局,请访问此 示例

数据库导出

如果您在团队中使用此 Laravel Admin 包,您会发现这个 artisan 命令备份和恢复数据库非常有用。

使用命令备份数据库

$ php artisan laravel-admin:dump-database

您将提示输入在 .env 中指定的 mysql 用户的密码。文件将保存在 /database/sla_dumps 中。

要在另一台机器上恢复数据库,请使用

$ php artisan laravel-admin:restore-database

注意 * 在导入之前始终先进行迁移,并且注意新导入与您的迁移状态兼容。您可以在导出文件之前以及在其他机器上导入之前,使用 Artisan 命令 php artisan migrate:status 检查这一点。

警告:此操作将会在database/sla_dumps文件夹中删除表并恢复最新的迁移。您将需要两次确认删除数据库。MySQL将多次提示您输入在.env中指定的MySQL用户的密码。我们不对任何数据丢失负责。请谨慎使用。

Bash别名

您可以在您的Homestead环境中创建Laravel Admin别名,例如,通过将以下函数添加到您的bash配置文件中(vi ~/.bash_aliases

function sla() {
    php artisan laravel-admin:"$1"
}

然后,如果您想执行php artisan laravel-admin:update,只需输入

$ sla update

文档

访问Wiki以获取详细的用法文档。

贡献

欢迎为Laravel Admin库做出贡献。在提交拉取请求之前,请注意以下指南。

  • 遵循PSR-2编码标准。
  • 为新的函数和新增的功能编写测试
  • 使用Laravel Mix处理资源

composer install

$ composer install

npm install

$ npm --prefix ./src install

bower install

$ cd src/resources/assets/src
$ bower install

构建

$ cd src
$ npm run production

许可证

此Laravel Admin是开源软件,根据MIT许可证授权。