SparkShop开源商城手册

    1、环境准备

    1、我们推荐通过 宝塔 来进行商城的搭建。系统推荐的环境是

    软件版本
    php8.2
    mysql5.7 或 8.0
    nginx1.20.2+
    redis7.0.5+
    Supervisor3.0.2+

    pro版本目前还是用 PHP 7.4 稍后会升级

    2、同时我们要给php开启扩展 fileinforedisexifevent
    同时将 disable_functions 中的 proc_open , pcntl_signalpcntl_signal_dispatchpcntl_fork , pcntl_wait ,pcntl_alarm 删除

    此处由于系统内的定时任务采用的是workerman,需要删除上述函数。如果还是担心安全问题。可以采用宝塔的定时任务等第三方系统来代替系统自带的定时任务。

    3、软件中心搜索 Supervisor 并安装

    4、准备好域名,你需要至少准备好2个域名,他们的用途如下(拿sparkshop.cn 举例子):

    域名用途
    www.sparkshop.cn用于 pc端、小程序api、admin管理后台访问使用,也就是主程序的域名
    h5.sparkshop.cn用于h5的独立站点使用

    h5并未放在程序的public目录下,需要你自己参照 5、编译小程序和h5 里面的单独新建一个静态站点访问

    6、小程序完成企业认证,注意必须是企业认证的,因为要获取手机号,非企业认证的无权限
    7、小程序隐私协议的设置,可以参考我的,这么写

    8、在小程序那边设置好你的安全域名
    9、发布小程序审核,由于带订单中心,所以,请填写订单中心的地址

    pages/order/order

    如果遇到需要你填写 '订单管理->订单信息录入的',填写 pages/order/detailpayOrderNo=${商品订单号}&channel=1 即可


    2、下载源码

    打开 https://gitee.com/nickbai/sparkshop 下载源码

    目录作用
    screenshootreadme截图用跟系统无关
    sparkshop系统后台+api源码
    web前端uniapp源码


    3、宝塔搭建

    1、新建网站

    2、上传源码

    将源码中的 sparkshop 目录上传到 新建的网站目录 ,比如 /www/wwwroot/sparkshop.cn

    配置运行目录为 public

    设置好伪静态

    location / {
    	if (!-e $request_filename){
    		rewrite  ^(.*)$  /index.php?s=$1  last;   break;
    	}
    }

    点击配置文件,在文件内添加

    location ~* \.(gif|jpg|jpeg|png|bmp|swf)$ {
      add_header Access-Control-Allow-Origin *;
      add_header Access-Control-Allow-Headers X-Requested-With;
      add_header Access-Control-Allow-Methods GET,POST,OPTIONS;
    }

    允许图片跨域

    3、开始安装

    访问网址比如 sparkshop.cn


    满足环境的话,则下一步

    开始进行数据库脚本的安装

    看到安装成功,则表示安装完成

    4、访问后台

    访问 域名/admin 则可访问后台 默认的账号为 admin 密码则为刚才你设置的密码


    4、系统配置

    系统安装好后,很多东西无法使用,我们需要对系统进行配置。

    1、系统设置

    2、支付配置

    微信支付,在微信商户平台找到对应的参数填入即可,并打开启用

    支付宝支付,h5模式下会显示支付宝支付,如果你想使用,填入相对应的参数即可

    余额支付,用户商品够买的时候快速支付,只需要打开即可

    3、小程序配置

    4、物流查询配置

    物流查询配置用于发货的物流查询,方便用户查看商品动向。我们用的是阿里云市场的一家接口,https://market.aliyun.com/products/57126001/cmapi021863.html#sku=yuncode1586300000 你只需要去购买即可使用

    5、短信配置

    系统采用的短信是阿里云短信,购买后找到对应的信息

    填入系统中

    签名和模板的选择

    申请的对应的模板,可以配到系统中,当然你也可以只用只一个模板,根据实际需要

    目前仅支持,申请的模板中填写一个变量,且必须为 ${code} ,否则就会失败。

    6、物流公司

    此处的物流公司管理,不能乱写,要根据 https://market.aliyun.com/products/57126001/cmapi021863.html#sku=yuncode1586300000 下面记录的

    填写到系统中

    7、存储配置

    默认开启的是本地存储,但是我们推荐您使用第三方的存储,开通对应的存储,填写对应的信息到系统中即可。

    如果想使用 阿里云OSS腾讯云COS七牛云KODO 请参考 三方存储设置

    8、定时任务的开启【重要】

    打开已经安装的 Supervisor

    输入命令

    php think crontab start

    这个启动主要用户系统内定时任务的执行,打开系统的定时任务,可见定时任务即可



    5、编译小程序和H5

    编译小程序

    通过 HBuilder X 打开源码的 web 文件,打开 manifest.json 找到小程序配置

    点击后面的重新获取,拿到你的appid,这个appid是uniapp给你分配的,方便后续的打包。

    找到 config/app.js 填写你的 系统域名,即上面部署的域名

    编译前,在项目的目录上右键 --> 重新识别项目类型

    点击 发行 --> 小程序-微信

    填写对应的信息,即可发布了,编译发布了

    编译完成后,会打开开发者工具。如果未打开,也可以自己打开开发者工具,并找到编译后的源码。打开web\unpackage\dist\build\mp-weixin
    上传之前勾选一些选项,避免因为超包问题无法上传

    点击上传,即可上传到小程序平台。

    接下来登陆微信小程序平台,提交审核即可

    编译h5

    配置的接口地址 config/app.js 和上面一致。点击 发行-->网站-PC Web

    编译后的地址在 web\unpackage\dist\build\h5

    将这些文件放到一个静态的h5域名指向的网站就可以了,比如 宝塔上新建一个静态站点 h5.sparkshop.cn,把编译后的 static 和 index.html 上传上去,就可以了


    6、客服的配置

    pro版本 V1.2.1只有拥有客服插件

    本客服系统基于的是 socket.io 的,因此在使用之前需要启动 socket.io 服务。

    1、配置环境
    宝塔打开 config/chat.php 设定的端口号

    // 端口
    'ws_port' => 9172

    宝塔 --> 安全 --> 添加端口规则

    服务器的安全组也要打开,阿里云在服务器的安全组,腾讯云在防火墙,以腾讯云为例

    2、配置 ssl 证书
    打开 config/chat.php

    return [
    
        // 端口
        'ws_port' => 9172,
    
        // 是否开启ssl
        'open_ssl' => true,
    
        // 是否开启自签名 自签名证书需要开启此处
        'is_self_ssl' => true,
    
        // ssl配置文件
        'context' => [
            'ssl' => [
                'local_cert'  => '/www/server/panel/vhost/cert/sparkshop.pfecms.com/fullchain.pem',
                'local_pk'    => '/www/server/panel/vhost/cert/sparkshop.pfecms.com/privkey.pem',
                'verify_peer' => false,
            ]
        ]
    ];

    open_ssl 配置为 true 开启
    is_self_ssl 这个配置,如果你的证书是 宝塔申请的比如 Let's Encrypt 的这种自签名的证书,需要设置为true,如果你的证书是第三方的阿里云,腾讯云的证书则设置为false
    local_cert 证书的路径
    local_pk 证书秘钥路径
    宝塔可在 网站-->配置-->配置文件 种查看,注意空格

    3、配置 supervisor 启动

    运行目录:选择 源码的根目录,注意不是public 是 和 app 同目录的地方
    启动命令:php think chat start

    企业微信配置参考这个文章

    https://work.weixin.qq.com/nl/act/p/a733314375294bdd