README

文档

安装

对于全新的项目，以下命令用于安装

laravel new 项目名称

composer require backpack/crud

composer require --dev backpack/generators

创建数据库并在 .env 文件中添加它！

php artisan backpack:install

重要：如果您想开发 madmin-core 包，您需要在根目录中创建一个 packages 文件夹，并在其中检出仓库！

composer require madtechservices/madmin-core

安装 Backpack PRO 扩展：[https://backpackforlaravel.com/products/pro-for-unlimited-projects](https://backpackforlaravel.com/products/pro-for-unlimited-projects)（安装部分）

composer require backpack/pro

安装后

运行命令后，在配置文件中设置以下值

config\backpack\base.php

'view_namespace' => 'madmin-core::',

'default_date_format' => 'YYYY. MMM. D.',

'default_datetime_format' => 'YYYY. MMM. D. HH:mm',

'avatar_type' => 'getProfileImageUrl',

'guard' => null,

'passwords' => null,

'project_name' => '项目名称',

'project_logo' => '项目名称',

'home_link' => '', // 仅适用于管理系统，否则 'admin'

'developer_name' => 'MAD Tech Services',

'developer_link' => 'https://madtechservices.com.au',

'show_powered_by' => false,

config\app.php

'timezone' => 'Europe/Budapest',

'locale' => 'hu',

config\base.php

'middleware_class' => [ ... \Madtechservices\MadminCore\app\Http\Middlewares\SetLangMiddleware::class, ]

config/backpack/crud.php

在此处填写区域设置，这些是可选的语言。

config\auth.php

'model' => Madtechservices\MadminCore\app\Models\User::class,

database\seeders\DatabaseSeeder.php

    public function run()
    {
        $this->call(\Madtechservices\MadminCore\Database\Seeds\MadminSeeder::class);
    }

app\Providers\RouteServiceProvider.php

public const HOME = '/';

别忘了正确填写 .env 文件！

之后，只需运行以下几个命令

php artisan migrate --seed

php artisan vendor:publish --tag=config

可选的包/扩展

修改后的 Backpack 设计

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

在 backpack-overrides.scss 文件中的 :root { 选择器中修改颜色。要生成颜色，使用此工具很有帮助：https://ionicframework.cn/docs/theming/color-generator

将新元素添加到 vite.config.js 文件中的 laravel -> input 数组

'resources/scss/backpack-overrides.scss'

将新元素添加到 config/backpack/base.php -> vite_styles 数组

'resources/scss/backpack-overrides.scss',

然后运行 yarn 并执行 yarn dev。

系统级别日志记录

打开 app\Exceptions\Handler.php 文件并修改 register 方法为以下内容

    public function register()
    {
        $this->reportable(function (Throwable $e) {
            if ($this->shouldReport($e)) {
                store_system_logs($e);
            }
        });
    }

Larastan

该包已预先安装，但对于每个系统，都需要创建 phpstan.neon 配置文件。

https://packagist.org.cn/packages/nunomaduro/larastan#1.0.3

之后，运行 ./vendor/bin/phpstan analyse 或自动化它。