README

提供精美 Laravel 仪表板核心功能的 Laravel 扩展包

演示： https://core.laravue.dev

入门指南

Laravue 提供企业级管理员仪表板所需的所有 Element UI 和丰富功能，因此强烈推荐用于项目启动。以下说明适用于将 Laravue 的核心功能集成到现有 Laravel 项目中或对其进行实验。

先决条件

Laravue 是基于 Laravel 构建的，因此您必须检查 Laravel 的系统要求，并在开始之前确保您的 NodeJS 已准备好。

安装

使用 composer 安装 laravue-core 扩展包

composer require tuandm/laravue-core

1.a 使用一键命令设置 Laravue

php artisan laravue:setup

此命令将执行以下步骤：

• 设置 JWT 密钥和 API 端点
• 发布 Laravue 供应商包/资源
• 安装 NPM 依赖项
• 创建 .babelc 文件（如果不存在）
• 设置 webpack.mix.js（请备份此文件以确保当前设置不会丢失）

1.b 手动设置

建议使用 laravue:setup 命令。如果您想手动安装，可以按照以下步骤操作：

.env 文件

生成用于认证的 JWT 密钥

php artisan jwt:secret

将以下两行添加到 .env 文件中

  BASE_API=/api
  MIX_BASE_API="${BASE_API}"

发布供应商包/资源

php artisan vendor:publish --provider="Tuandm\Laravue\ServiceProvider" --tag="laravue-core"
php artisan vendor:publish --provider="Tuandm\Laravue\ServiceProvider" --tag="laravue-asset"

添加 NPM 依赖项

npm add babel-plugin-syntax-dynamic-import babel-plugin-syntax-jsx babel-plugin-transform-vue-jsx eslint eslint-loader eslint-plugin-vue laravel-mix-eslint vue-template-compiler svg-sprite-loader --save-dev

npm add element-ui js-cookie normalize.css nprogress vuex vue-count-to vue-i18n vue-router 

npm install # To make sure everything is set

请参阅 package.json 示例

Webpack.mix.js 配置

我们需要修改 webpack.mix.js 以与 Laravue 包一起使用，请参阅 webpack.mix.js 示例

或者简单运行此命令以生成推荐版本。

php artisan laravue:webpack

Babel

Laravue 需要 babel 来构建包。通常，.babelrc 将由 laravue:setup 命令 生成。如果您的项目已经使用它，请在 .babelrc 文件中手动添加所需的插件。示例 .babelrc 可以在此处找到 这里

2. 配置 API 守卫

打开 config/auth.php 并按以下方式修改：

    # Change default auth guard to api
    'defaults' => [
        'guard' => 'api',
    ],
    ...
    # Use JWT driver for api guard
    'guards' => [
    ....
    'api' => [
        'driver' => 'jwt',
    ....
    
    # Use Laravue User model to authenticate
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => Tuandm\Laravue\User::class,
        ],

请参阅 auth.php 示例

3. 数据库

Laravue 核心需要 users.role 字段，如果需要，请运行迁移

php artisan migrate

4. 示例数据

此数据库种子将插入 3 个测试用户，如果您已有数据，可以忽略此步骤。

php artisan db:seed --class=Tuandm\\Laravue\\Database\\Seeds\\DatabaseSeeder

开始开发

npm run dev # or npm run watch

构建生产环境

npm run production

运行测试

• 测试系统正在开发中。

使用

• Laravel - PHP Web艺术家的框架
• VueJS - 进步的JavaScript框架
• Element - 开发者、设计师和产品经理的Vue 2.0组件库
• Vue Admin Template - 基于Element UI的最小化Vue管理模板

贡献

请阅读CONTRIBUTING.md以了解我们的行为准则以及向我们提交拉取请求的流程。

版本控制

我们使用SemVer进行版本控制。有关可用版本，请参阅本存储库的标签。

作者

• 杜天 - 初始工作 - tuandm

还可以查看参与此项目的贡献者列表。

许可

本项目采用MIT许可证 - 有关详细信息，请参阅LICENSE.md文件

致谢

• Laravue - 使用VueJS和ElementUI构建的Laravel美观仪表盘
• vue-element-admin 一个灵感的Vue管理，启发了Laravue项目
• tui.editor - Markdown WYSIWYG编辑器
• Echarts - 浏览器的一个强大、交互式的图表和可视化库