MineAdmin

快速开始

所需环境

环境描述是否必须操作
SwooleSwoole >= 5.0 (建议 5.1 以上版本)必须安装教程open in new window
PHPPHP >= 8.1必须-
MySqlMySql >= 5.7可选默认自带、无需额外安装
PgSqlPgSql >= 14可选安装教程open in new window
MsSqlSqlServer Latest可选安装教程open in new window
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'

下载代码

下载后端代码

下载前端代码

小提示

安装完成后会提示 Do you downloading the front-end code to "./web" directory?(yes) 后会 ./web 创建下载最新前端代码，[需注意](/faqs/#插件安装需知-前端不生效 无页面)

后端安装与启动

后端安装

提示

后端安装需要先配置好 env 文件，然后执行 mine:install 进行数据迁移

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

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

# 下载或克隆项目后，进入到后端根目录
cd mineadmin

# 安装依赖
composer install

#-----------------------------------------------------------------------------------

# 方式2

composer create-project mineadmin/mineadmin --keep-vcs
  1. 配置 .env 填写 redis db 相关信息，保存关闭。
  2. 打开终端，执行安装命令，执行Migrates数据迁移文件和SQL数据填充，完成安装。
php bin/hyperf.php mine:install

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

/---------------------- welcome to use -----------------------\
|               _                ___       __          _      |
|    ____ ___  (_)___  _____    /   | ____/ /___ ___  (_)___  |
|   / __ `__ \/ / __ \/ ___/   / /| |/ __  / __ `__ \/ / __ \ |
|  / / / / / / / / / / /__/   / ___ / /_/ / / / / / / / / / / |
| /_/ /_/ /_/_/_/ /_/\___/   /_/  |_\__,_/_/ /_/ /_/_/_/ /_/  |
|                                                             |
\_____________  Copyright MineAdmin 2021 ~ 2022  _____________|
MineAdmin Version: 2.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