项目安装搭建全流程说明

本项目基于PHP7.2+MySQL5.6开发，需依赖 RedisPHP 扩展，整体搭建分为服务端部署、后台配置、前端打包三大核心环节，同时支持 SSL 配置、多城市管理等个性化设置，以下为详细分步操作指南。

源码获取看底部

一、前期环境准备

核心运行环境

服务端：PHP7.2、MySQL5.6

必装扩展：Redis（需确保 PHP 已开启该扩展，可通过php -m命令验证）

服务器：支持 Apache/Nginx（需开启 URL 重写模块）

工具：数据库管理工具（Navicat/PhpMyAdmin）、HBuilderX（前端打包）

环境检查要点

确认 MySQL5.6 服务正常运行，可正常创建、导入数据库

PHP7.2 需开启 PDO、MySQLi 等基础扩展，与 Redis 扩展共同生效

服务器开放 80（HTTP）/443（HTTPS）端口，便于域名访问

二、服务端部署步骤

1. 源码上传与数据库导入

将项目源码通过 FTP / 宝塔面板等工具上传至服务器指定目录

打开数据库管理工具，新建空数据库（建议字符集设为 utf8mb4）

找到项目根目录下的数据库备份文件，导入前先编辑文件：全局搜索www.bygoukai.com，将其全部替换为你的项目域名（如www.xxx.com）

替换完成后，将数据库文件导入新建的空数据库中

2. 数据库配置修改

找到项目根目录下的.env配置文件，编辑以下数据库相关参数，与本地 / 服务器数据库信息保持一致：

plaintext

DB_HOST=数据库IP（本地为127.0.0.1）

DB_PORT=3306

DB_DATABASE=数据库名

DB_USERNAME=数据库账号

DB_PASSWORD=数据库密码

保存文件后，确保配置文件无语法错误，避免数据库连接失败。

3. ThinkPHP 伪静态配置

本项目基于 ThinkPHP 框架开发，需配置伪静态实现 URL 美化，Apache/Nginx 环境配置方法不同，具体操作如下：

Apache 环境

确认服务器已开启mod_rewrite重写模块（可通过apache2ctl -M | grep rewrite验证）

在项目根目录创建 / 编辑.htaccess文件，添加以下规则：

plaintext

RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ index.php?s=/$1 (QSA,PT,L)

确保虚拟主机配置中AllowOverride设为All，使.htaccess文件生效

Nginx 环境

找到 Nginx 配置文件（通常在/etc/nginx/conf.d/目录），在对应域名的server块中添加以下规则：

plaintext

location / {

if (!-e $request_filename) {

rewrite ^/(.*)$ /index.php?s=/$1 last;

break;

}

}

location ~ \.php$ {

fastcgi_pass 127.0.0.1:9000;

fastcgi_index index.php;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

include fastcgi_params;

}

保存配置后，执行nginx -s reload重启 Nginx 使规则生效

4. 运行目录与防跨站设置

将服务器的项目运行目录设为 public（ThinkPHP 框架默认入口目录，提升安全性）

在服务器面板 / 配置文件中关闭网站防跨站限制，避免项目静态资源、接口访问被拦截

5. SSL 证书配置

SSL 证书根据个人 / 企业需求申请（免费版可选择 Let’s Encrypt、宝塔免费 SSL 等），申请后按服务器类型（Apache/Nginx）完成证书部署，部署后可通过https://你的域名安全访问项目，证书部署不影响项目核心功能，为可选操作。

三、后台系统配置与使用

1. 后台登录

完成服务端部署后，通过浏览器访问你的域名/admin，输入默认账号密码登录：

账号：admin

密码：123456首次登录建议立即修改默认密码，提升后台安全性。

2. 核心参数配置

登录后台后，在【系统设置】中完成以下关键配置，确保项目功能正常：

公众号配置

：填写微信公众号的 AppID、AppSecret，完成公众号与项目的对接，支持微信授权、消息推送等功能

支付信息配置

：根据业务需求，配置微信支付 / 支付宝支付的商户号、支付密钥、回调地址等参数

腾讯地图密钥配置

：填写已申请的腾讯地图 Key（获取教程见下文），支持地图定位、地址解析等功能

城市设置

：在【系统设置 – 城市设置】中，可新增、编辑、删除城市信息，适配多城市业务场景

四、前端项目打包

本项目前端基于 Vue 开发，需通过HBuilderX工具完成打包部署，具体步骤如下：

1. 前端源码打开

下载并安装 HBuilderX 工具（标准版 / APP 开发版均可）

打开 HBuilderX，选择【文件 – 打开目录】，找到项目前端源码路径前端\anmo-vue\wechat，导入整个 wechat 目录

2. 域名与信息替换

在 HBuilderX 中，对前端源码进行全局搜索替换：

快捷键 Ctrl+Shift+F 打开全局搜索，输入www.bygoukai.com

将所有搜索结果替换为你的项目域名（与服务端替换的域名保持一致）

替换完成后，保存所有修改的文件

3. 前端基础配置

找到前端项目的基础配置文件，分配微信公众号 / 小程序的Appid，确保与后台配置的 Appid 一致

进入项目【源码视图】，找到腾讯地图配置项，填写已申请的腾讯地图 Key和公众号 ID，完成地图功能对接

4. 前端打包部署

在 HBuilderX 中，右键点击前端项目根目录，选择【运行 – 运行到浏览器】，本地测试前端功能是否正常

测试无误后，右键点击项目根目录，选择【发行 – 原生 App – 云打包 / 网页版打包】，根据部署需求选择打包类型

打包完成后，将生成的前端静态文件（dist 目录）上传至服务器对应目录，与服务端对接

五、腾讯地图 Key 获取教程

项目地图功能依赖腾讯地图 API，需提前申请专属 Key，个人 / 企业均可申请，实名认证后生效，具体步骤如下：

打开【腾讯位置服务官网】（），点击右上角【控制台】，通过微信 / QQ / 邮箱完成登录

进入控制台后，选择【应用管理 – 创建应用】，填写应用名称（如 “项目地图服务”）、应用描述，完成应用创建

找到刚创建的应用，点击【管理 – 创建密钥（KEY）】，选择应用类型为WebService API（适配项目后台接口调用）

配置密钥白名单（建议填写服务器 IP / 项目域名，防止密钥被盗用），无需白名单可留空（仅开发测试使用）

点击【创建】，系统自动生成一串腾讯地图 Key（格式为 DOKBZ-XXXXX-XXXXX-XXXXX）

复制该 Key，分别填写至项目后台和前端源码的地图配置项中，完成对接测试 Key 有效性：可通过浏览器访问腾讯地图测试接口，替换 Key 后若返回 JSON 数据，说明 Key 配置正常。

六、常见问题排查

数据库连接失败

检查.env配置文件的数据库参数是否正确，服务器数据库是否开放远程访问，防火墙是否拦截 3306 端口

伪静态配置后 404

确认 Apache/Nginx 重写模块已开启，伪静态规则路径与项目运行目录匹配，ThinkPHP 框架缓存已清除

前端地图功能失效

检查腾讯地图 Key 是否正确，应用类型是否为 WebService API，白名单是否限制了服务器 IP / 域名

后台登录无响应

确认运行目录已设为 public，防跨站限制已关闭，PHPRedis 扩展已正常开启

更多源码可以去狗凯之家源码网搜索关键词：按摩