LaravelAdmin#

介绍#

laravel-admin 是一个可以快速帮你构建后台管理的工具，它提供丰富的页面组件和表单元素，还有即插即用的功能组件，通过简单的配置或使用少量的代码就实现完善的后台管理功能。(QQ 群: 391528810)

Demo || 阅读文档

QQ 群: 391528810

特点#

• Laravel+Vue 组合
• SPA 单页面应用
• 前后端分离，后台只提供 API 接口，前端负责视图渲染
• 开箱即用的 laravel 后台管理系统
• 海量 Vue 组件直接拿来即用

截图#

软件架构#

基于 laravel 框架实现前后端分离的单页面应用架构

使用相关技术:vue+bootstrap+phpswoole+docker+laravel

安装前准备#

1. 提前安装好 git (整套部署流程使用 git 方式部署，请依照文档通过 git clone 命令安装)

2. Windows 安装请先手动安装好 docker (电脑需支持 Hyper-V), 并执行命令 docker-compose -v 检查 docker 是否已安装成功

3. Windows 注意要进入容器请在命令前加上”winpty “

4. Windows 请手动设置下载源为国内镜像源

{
  "registry-mirrors" : [ "https://mirror.ccs.tencentyun.com", "http://registry.docker-cn.com", "http://docker.mirrors.ustc.edu.cn", "http://hub-mirror.c.163.com" ],  "insecure-registries" : [ "registry.docker-cn.com", "docker.mirrors.ustc.edu.cn" ],  "debug" : true,  "experimental" : true}
Copy

5. Windows 的其它设置参照

6. 设置预将代码存放目录的上级目录跟”~“目录必须包含 dokcer 的 File Sharing 列表中的目录中 (Windows 环境的”~“目录为” C:/Users/Administrator”)

我的 Windows 电脑只有一个 C 盘，直接选的 C 盘

7. 上面内容设置到 docker 设置中后记得点应用

8. Windows 环境请进入 git bash 命令行工具进行执行安装

安装教程#

1. 下载代码

git clone https://gitee.com/laravel-admin/laraveladmin.git
cd laraveladmin
git remote add laraveladmin https://gitee.com/laravel-admin/laraveladmin.gitCopy

2. 参照.env.example 配置.env 文件 (务必设置好 mysql 密码，redis 密码)

• 数据库连接用户请使用 root, 程序需要检查数据库是否存在并创建数据库，开发环境的代码生成是通过读取数据表结构进行代码生成的

cp .env.example .env
vi .envCopy

3. 初始化安装

sh ./docker/install.shCopy

4. 请用 phpstorm 编辑器查看./docker/mysql/init.sql 密码值是否存在换行问题，如有请处理一下，不然后面数据库连接不上

5. php 容器环境中安装 composer 相关扩展包及项目代码初始化

如果安装”laravel/envoy” 过程中失败请切换下全局镜像源，进行尝试

• 腾讯云 composer 镜像源:mirrors.cloud.tencent.com/composer - 阿里云 composer 镜像源:mirrors.aliyun.com/composer - 华为云 composer 镜像源:mirrors.huaweicloud.com/repository... - laravel (中国) composer 镜像源:packagist.laravel-china.org - phpcomposer:packagist.phpcomposer.com

  winpty docker-compose run --rm php composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer #设置镜像源
  winpty docker-compose run --rm php composer global require laravel/envoy -vvv #该命令出错了请切换镜像源
  winpty docker-compose run --rm php composer global dump-autoload
  winpty docker-compose run --rm node cnpm install #前端编译扩展包安装
  winpty docker-compose run --rm node npm run prod #编译前端页面js
  winpty docker-compose run --rm php chmod u+x docker/php/run.sh #启动命令添加执行权限
  winpty docker-compose run --rm php envoy run init --branch=master #项目初始化
  winpty docker-compose up -d #启动服务Copy

执行命令 winpty docker-compose ps 显示 php 容器一直 restart 的状态是部分 Windows docker 对”docker/php/run.sh” 的文件编码不能识别问题！请执行如下操作

winpty docker-compose down
winpty docker-compose run --rm php bash
mv docker/php/run.sh docker/php/run.sh.back
echo '' > docker/php/run.sh
cat docker/php/run.sh.back >> docker/php/run.sh
chmod u+x docker/php/run.sh
chmod 777 docker/php/run.sh
exit
winpty docker-compose up -d
winpty docker-compose psCopy

安装完成请在编辑器排除这两个目录防止编辑器被卡死

6. 系统已安装有 nginx 服务器导致端口 (80,443) 冲突依据如下进行配置

• 将 nginx 容器暴露宿主机端口修改防止冲突

vim docker-compose.ymlCopy

• 设置本机已有的 nginx 代理配置 ```
  server
  {
  listen 80; server_name local.laraveladmin.cn; location / { proxy_http_version 1.1; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Real-PORT $remote_port; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $http_host; proxy_set_header Scheme $scheme; proxy_set_header Server-Protocol $server_protocol; proxy_set_header Server-Name $server_name; proxy_set_header Server-Addr $server_addr; proxy_set_header Server-Port $server_port; proxy_pass 127.0.0.1:81; #docker 容器中运行的 nginx 设置成 host.docker.internal:81 }}

  Copy

7. 访问

本地开发环境绑定 hosts 后就可以进行访问了

127.0.0.1 local.laraveladmin.cnCopy

登录用户名及密码参照.env 中的”ADMIN_USER_NAME”,”ADMIN_PASSWORD” 设置项
登录验证码使用的极验滑块验证 (免费的), 注册后在.env 中进行配置

8. 开发环境前端实时编译启动

winpty docker-compose run --rm node npm run watchCopy

9. 添加自己的代码仓库源

git remote remove origin
git remote add origin https://用户名:密码@gitee.com/自己代码仓库.gitCopy

10. 本地开发环境更新到 laraveladmin 最新代码

git pull laraveladmin masterCopy

11. 线上代码更新升级部署

docker-compose exec php envoy run update --branch=masterCopy

使用说明#

1. 官网及相关文档: https://www.laraveladmin.cn

2. 在线示例演示环境: https://demo.laraveladmin.cn

用户名:demo_admin

密码:admin123456

参与贡献#

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request