README

提供核心功能的Laravel包，用于构建漂亮的Laravel仪表盘

入门

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 - 专为Web工匠设计的PHP框架
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 受到 Laravue 项目启发的神奇 Vue 管理系统
tui.editor - Markdown WYSIWYG 编辑器
Echarts - 一个强大的、交互式的浏览器图表和可视化库

tkien / laravue-core

维护者

详细信息