外卖平台小程序安装说明书（微信小程序 + Golang + PHP）

By Codapp.Cn Posted on 2025-07-26 Posted in 帮助文档浏览数 36

本说明适用于本外卖平台小程序的完整部署，包含服务端（Golang）、客户端（微信小程序）和后台管理端（PHP 5.6）。

如果你正在寻找一套适合餐饮店快速上线的外卖系统解决方案，这份《外卖平台小程序安装说明书》将为你提供从0到1的完整部署教程。CodApp 外卖系统采用 微信小程序 + Golang 高性能服务端 + PHP 5.6 后台管理系统 架构，兼具扫码点餐与外卖平台一体化功能，适合中小商家自主搭建和维护。通过本说明书，你将掌握如何配置数据库、部署 Golang 服务、安装 PHP 后台，并快速打包发布小程序。本系统源码全部开放，支持本地部署、二次开发，无抽佣、无年费、不依赖第三方平台，真正实现外卖平台自营掌控。现在就开始打造你的专属微信外卖小程序吧！

一、系统结构概览

本系统包含 3 个子系统：

服务端：Golang 开发，监听 9100 端口，通过 Nginx 代理为 api.xxx.com
客户端：Vue3 + Vite 构建的 H5 应用，部署为 www.xxx.com
后台管理端：PHP 5.6 开发，部署为 admin.xxx.com

二、服务端部署（Golang）

1. 环境要求

Linux 系统
Supervisor（用于守护进程）
Nginx（用于反向代理）
MySQL、Redis 数据库服务

2. 数据库准备

创建数据库：wmp
导入初始化 SQL 文件（如 init_db.sql）

3. 将 api 上传至服务器 /var/www/html/api，并配置文件 conf.ini（JSON 格式）

请修改 /var/www/html/api 权限为可写可执行请修改 conf.ini 文件中的内容如下，替换为你的数据库与 Redis 配置：

 {
        "Db": {
            "Driver": "mysql",
            "Host": "你的数据库地址，例如 127.0.0.1 或公网地址",
            "Name": "数据库名称，例如 wmp",
            "User": "数据库用户名，例如 root",
            "Password": "数据库密码，例如 yourpassword",
            "Port": "3306",
            "Charset": "utf8"
        },
        "Cache": {
            "Driver": "redis",
            "Host": "Redis 地址，例如 127.0.0.1",
            "Num": "0",
            "Port": "6379",
            "Auth": "Redis 密码，如果没有可为空字符串"
        },
        "Conf": {
            "Name": "项目名称，例如 ofH5",
            "QQLbsKey":"腾讯地图后端KEY",
            "Port": "9100",  // 服务端监听端口，默认 9100
            "Secret": "123456", // 接口加密密钥，请保持复杂度,下面客户端和后台端都保持一致"
            "WeChatPayCertFile":"./cert/apiclient_cert.pem", // 微信支付证书
            "WeChatPayKeyFile":"./cert/apiclient_key.pem"    // 微信支付证书秘钥
        }
 }

4. 使用 Supervisor 管理 Golang 服务

创建文件 /etc/supervisor/conf.d/wmp.conf，内容如下：

[program:wmp]
directory=/var/www/html/api
command=/home/www/server/wmServerGo
autostart=true
autorestart=true
stderr_logfile=/var/log/wmp.err.log
stdout_logfile=/var/log/wmp.out.log

执行命令：

supervisorctl reread
supervisorctl update
supervisorctl start wmp

5. 配置 Nginx（服务端代理）

server {
        listen 443 ssl;
        server_name api.xxx.com;
        ssl_certificate /etc/ssl/server.crt;
        ssl_certificate_key /etc/ssl/server.key;
        location / {
            proxy_pass http://127.0.0.1:9100;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
}

三、后台管理端部署（PHP 5.6）

1. 环境准备

安装支持 PHP 5.6 的 LNMP 环境
上传后台代码至 /var/www/html/admin
上传文件夹给与写入权限 /var/www/html/admin/Public/Static/upload
修改配置文件 Lib/Config/Config.php 配置连接信息
后台登录地址：https://admin.xxx.com
默认管理员账号：18888888888
默认管理员密码：123456

'Host' => 'https://api.xxx.com',
'Cdn' => 'https://api.xxx.com',
'Secret' => '123456',

2. 配置 Nginx（后台站点）

server {
        listen 443 ssl;
        server_name admin.xxx.com;
        ssl_certificate /etc/ssl/admin.crt;
        ssl_certificate_key /etc/ssl/admin.key;        
        root /var/www/html/admin/Public; #注意这里绑定的是目录下的Public文件夹
        location / {
            index  index.html index.htm index.php;
            if (!-e $request_filename) {
                    rewrite  ^.*$  /index.php  last;
                    break;
            }
        }
        location ~ \.php$ {
            include fastcgi_params;
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        }
}

四、微信小程序部署

1. 使用微信开发者工具导入项目

打开微信开发者工具，点击「导入项目」
选择项目目录：/微信小程序
AppID 可临时填写（测试）或填写你自己的小程序 AppID

2. 配置服务端接口地址

打开配置文件：/微信小程序/config.js
修改以下配置为你的正式服务端信息：

const config = {
    QQMAP_KEY: "腾讯地图小程序KEY",
    QQMAP_REFERER: "外卖平台",
    SERVER_KEY: "123456",
    ColorMain: "#ff6600",
    BgColorMain: "#F5F5F7",
    Release: { 
        API_URL: "https://api.xxx.com",
        CDN_URL: "https://api.xxx.com",
    },
}

3. 上传并提交审核