MineAdmin

快速开始

所需环境

环境描述是否必须操作
SwooleSwoole >= 4.8.x，Hyperf框架运行基础基于Swoole必须安装教程open in new window
PHPPHP >= 8.0必须-
MysqlMysql >= 5.7 且 <= 8.0 (需支持innodb引擎、开发环境为5.7版本)必须-
NodeJsNodeJs >= 14.18.3 前端开发环境 (包含NPM依赖安装工具)必须-
ComposerComposer >= 2.x.x PHP依赖包安装工具必须-
RedisRedis >= 4.0.0必须-
RabbitMQRabbitMQ >= 3.x.x，消息队列所需软件，系统默认未开启队列功能非必须-

开放被禁用的函数

开放以下函数

  • putenv
  • shell_exec
  • proc_open
  • pcntl_ 开头的函数

或者打开 php.ini （命令行版本），查找 disable_functions 关键字，复制下面文本，替换原有的：

disable_functions = passthru,system,chroot,chgrp,chown,popen,ini_alter,ini_restore,dl,openlog,syslog,readlink,symlink,popepassthru,imap_open,apache_setenv

关闭Swoole短名称

打开 php.ini 在最后一行加入

swoole.use_shortname = 'Off'

下载代码

下载后端代码

下载前端代码

小建议

可以在后端根目录建一个 web 目录，把前端的源代码放在这个 web 目录下，这样方便更好管理项目

后端安装与启动

后端安装

提示

后端安装需要执行两次安装命令，第一次是为了生成 .env 文件，第二次是安装数据。

如果自行复制 .env.example 文件改名成 .env 后只需要执行一次，但在用户登录时会出现报错，可参考这里解决：解决方法

  • 打开终端，进入到后端根目录，按照以下命令安装后端
# 进入到后端根目录
cd mineadmin

# 安装依赖
composer install
  1. 执行 cp .env.example .env 复制一份 env 配置文件
  2. 配置 .env 内的 redis mysql amqp(可选) 等相关配置
  3. 确认配置完相关配置后，执行mine:install 将执行数据迁移

待显示以下信息，系统已经安装完成。

/---------------------- welcome to use -----------------------\
|               _                ___       __          _      |
|    ____ ___  (_)___  _____    /   | ____/ /___ ___  (_)___  |
|   / __ `__ \/ / __ \/ ___/   / /| |/ __  / __ `__ \/ / __ \ |
|  / / / / / / / / / / /__/   / ___ / /_/ / / / / / / / / / / |
| /_/ /_/ /_/_/_/ /_/\___/   /_/  |_\__,_/_/ /_/ /_/_/_/ /_/  |
|                                                             |
\_____________  Copyright MineAdmin 2021 ~ 2022  _____________|
MineAdmin Version: 1.0.0
default username: superAdmin
default password: admin123

启动后端

开发环境可以使用热更新方式来启动，在根目录执行下面的启动命令即可 （生产环境不要用热更新）

php watch -c

官方启动命令：

php bin/hyperf.php start

提示

也可以使用官方的热更新插件open in new window

前端安装与启动

前端安装

  • 打开终端，进入到前端根目录，按照以下命令安装前端依赖
# 进入到后端根目录
cd mineadmin-vue

# 安装依赖
yarn install

启动前端

yarn dev

前端打包

yarn build

前端预览

在前端打包后，可以以web服务器方式预览打包后的兼容性等问题，这是部署前必要的操作。

yarn preview