芸众商城安装部署教程（单服务器宝塔环境）

安装教程是基于单服务器宝塔环境的教程，其他环境可以自行研究。
一、环境要求和环境搭建
1、官方环境要求
1）服务器系统：centos stream 9 64位
2）配置要求：双核8G内存，带宽20M，磁盘100G，或更高
3）软件环境要求：Nginx latest、mysql8.0.x、PHP7.4.33、redis5,6,7
2、环境说明
1）PHP需要支持模块（正常安装后大多都支持，可以根据情况查看验证是否支持）
bcmath、Core、ctype、curl、date、dom、fileinfo、filter、ftp、gd、gettext、hash、iconv、json、libxml、mbstring、mcrypt、mongodb、mosquitto、mysqli、mysqlnd、openssl、pcntl、pcre、PDO、pdo_mysql、pdo_sqlite、Phar、posix、readline、redis、Reflection、session、SimpleXML、sockets、sodium、SPL、sqlite3、standard、sysvsem、tokenizer、wxwork_finance_sdk、xml、xmlreader、xmlrpc、xmlwriter、xsl、Zend OPcache、zip、zlib
2）PHP不能禁用的函数（配置方法可以自行搜索）
proc_xxx,putenv，pcntl_signal，pcntl_fork，pcntl_wait,pcntl_alarm,pcntl_signal_dispatch，stream_socket_server
3）PHP需要安装的拓展
fileinfo，redis
4）MySQL数据库官方建议8，验证后5.7类似也可，但需要支持Innodb
5）确保curl（7.6x）或以上和openssl-1.1.1（因官方不再支持1.0.2版本,所以建议安装1.1.1版本,新安装不要再使用1.0.2）
6）PHP需要配ca证书
7）服务器端口开启：
80，3306，443，6379，9001（如果使用诸如阿里云、腾讯云或者华为云等，需要在安全策略里面对一些端口放行9001除外），操作方法请参考对应云服务的安全策略说明
8）Supervisord安装
进程守护安装，根据官方的说明和实验证明，不要使用宝塔直接安装，需要使用命令行在SSH终端进行安装（配置可以使用宝塔的文件管理进行操作，也可以通过命令行，根据自己的需要即可），具体的安装配置参考下方的部署步骤中的方法
9）其他
二、后端部署
1、官方的常规部署方法如下，不做过多的说明：
1）git clone https://github.com/yunzmall/shop.git 商城核心代码#
2）cd shop#
3）新建.env#

Plain Text

APP_ENV=dev
APP_KEY=base64:2q7s0Z714xS1L1WNN/8dsB69XDqOb4Qdptgh4X2ZtZU=
APP_DEBUG=true
APP_LOG_LEVEL=debug

APP_Framework=platform
IS_WEB=/admin/shop
ROOT_PATH=''
EXTEND_DIR=''

4）mkdir -p addons/yun_shop#
5）cd addons/yun_shop#
6）git clone https://github.com/yunzmall/framework_page.git 后台管理vue页面#
7）cd framework_page#
8）vim config/index.js 修改build选项
build: {
index: path.resolve(__dirname, “../../../../admin.html”),
assetsRoot: path.resolve(__dirname, “../../”),
9）安装nodejs、npm#
下载地址 https://nodejs.org/zh-cn/download/
10）运行npm install命令安装vue依赖库#
11）运行npm run build:prod命令编译文件#
12）apache web服务器在根目录下创建.htaccess文件 ngnix不用创建#

Plain Text

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /index.php?/$1 [QSA,PT,L]

13）安装php依赖组件#

Plain Text

composer install

14）安装向导数据库配置（这一步比较简单，填写配置运行安装即可）
15）安装完成后访问后台即可https://yourdomain/admin.html
2、源码安装（通过获得的源码和sql文件等进行部署）：
1）宝塔面板新加站点和数据库之类的不做详细说明，请自行搜索对应的教程
将已获得的源码上传到站点根目录，解压，如图

3）配置站点伪静态，如图

将如下内容添加到伪静态设置，保存

Plain Text

location / {
try_files $uri $uri/ /index.php?$query_string;
}

location /ws {
proxy_pass http://127.0.0.1:8181;
}

4、SSL配置，使用宝塔面板的话可以申请Let’s Encrypt申请免费的证书，如果有自己的证书或者其他方式获得的证书可自行配置

5）配置数据库链接：
数据库链接文件位置为/database/config.php
内容如下，将配置参数修改为你的数据库链接参数即可（主要修改红色部分）：

PHP

<?php
$config = array();
$config['db']['master']['host'] = '127.0.0.1';
$config['db']['master']['username'] = 'db_username';
$config['db']['master']['password'] = ‘db_password’;
$config['db']['master']['port'] = '3306';
$config['db']['master']['database'] = 'db_name';
$config['db']['master']['tablepre'] = 'ims_';

$config['db']['slave_status'] = false;
$config['db']['slave']['1']['host'] = '';
$config['db']['slave']['1']['username'] = '';
$config['db']['slave']['1']['password'] = '';
$config['db']['slave']['1']['port'] = '';
$config['db']['slave']['1']['database'] = '';
$config['db']['slave']['1']['tablepre'] = '';

6）数据库导入：
在数据库管理的位置将sql文件导入到已有的数据库内即可（sql导入方法请自行搜索）
7）删除源码之前可能存在的换成，不删除可能会出现如下图片一显示的错误，删除方法如下图二的换成文件位置

图片一

图片二

8）完成后理论上您可以通过https://yourdomainname/admin.html进行后台访问
3、访问后配置商城等相关参数即可，其中上面提到的进行守护等需要单独配置才可以实现比如队列、订单监测等一些自动化的功能，这里介绍进队列的配置、进程守护的配置等：
1）访问https://yourdomain/admin/shop?route=supervisord.supervisord.index
2）服务器IP设置，如下图

3）队列设置

4）域名替换（根据需求即可，一般不需要）

5）Redis设置（正常默认即可）

6）Webscoket设置，需要开启：

7）终端管理，这里前面的如果配置完成的话后三个会是绿色显示，第一个守护进程需要配置supervisor后才会是正常：

配置方式如下：
①登录服务器SSH终端
②执行安装supervisor，安装默认安装位置即可，方便后面的配置
yum install supervisor
配置supervisor，找到配置文件，这里演示的配置文件通过宝塔的文件管理可以找到是在/etc/supervisord.conf这个位置

打开文件进行编辑，注意主要是下面标红的位置必须设置

Plain Text

; Sample supervisor config file.
[unix_http_server]
file=/run/supervisor/supervisor.sock   ; (the path to the socket file)
;chmod=0700                 ; sockef file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))

[inet_http_server]         ; inet (TCP) server disabled by default
port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for all iface)
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))

[supervisord]
logfile=/var/log/supervisor/supervisord.log  ; (main log file;default $CWD/supervisord.log)
logfile_maxbytes=50MB       ; (max main logfile bytes b4 rotation;default 50MB)
logfile_backups=10          ; (num of main logfile rotation backups;default 10)
loglevel=info               ; (log level;default info; others: debug,warn,trace)
pidfile=/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
nodaemon=false              ; (start in foreground if true;default false)
silent=false                 ; no logs to stdout if true; default false
minfds=1024                 ; (min. avail startup file descriptors;default 1024)
minprocs=200                ; (min. avail process descriptors;default 200)
;umask=022                  ; (process file creation umask;default 022)
;user=chrism                 ; (default is current user, required if root
;identifier=supervisor       ; (supervisord identifier, default is 'supervisor')
;directory=/tmp              ; (default is not to cd during start)
;nocleanup=true              ; (don't clean up tempfiles at start;default false)
;childlogdir=/tmp            ; ('AUTO' child log dir, default $TEMP)
;environment=KEY=value       ; (key value pairs to add to environment)
;strip_ansi=false            ; (strip ansi escape codes in logs; def. false)
; the below section must remain in the config file for RPC
; (supervisorctl/web interface) to work, additional interfaces may be
; added by defining them in separate rpcinterface: sections

[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]
serverurl=unix:///run/supervisor/supervisor.sock ; use a unix:// URL  for a unix socket
;serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
;username=chris              ; should be same as http_username if set
;password=123                ; should be same as http_password if set
;prompt=mysupervisor         ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history  ; use readline history if available
; The below sample program section shows all possible program subsection values,
; create one or more 'real' program: sections to be able to control them under
; supervisor.

;[program:theprogramname]
;command=/bin/cat              ; the program (relative uses PATH, can take args)
;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
;numprocs=1                    ; number of processes copies to start (def 1)
;directory=/tmp                ; directory to cwd to before exec (def no cwd)
;umask=022                     ; umask for process (default None)
;priority=999                  ; the relative start priority (default 999)
;autostart=true                ; start at supervisord start (default: true)
;autorestart=true              ; retstart at unexpected quit (default: true)
;startsecs=10                  ; number of secs prog must stay running (def. 1)
;startretries=3                ; max # of serial start failures (default 3)
;exitcodes=0,2                 ; 'expected' exit codes for process (default 0,2)
;stopsignal=QUIT               ; signal used to kill process (default TERM)
;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
;user=chrism                   ; setuid to this UNIX account to run the program
;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
;stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
;stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
;stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
;stdout_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
;stdout_events_enabled=false   ; emit events on stdout writes (default false)
;stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
;stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
;stderr_logfile_backups=10     ; # of stderr logfile backups (default 10)
;stderr_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
;stderr_events_enabled=false   ; emit events on stderr writes (default false)
;environment=A=1,B=2           ; process environment additions (def no adds)
;serverurl=AUTO                ; override serverurl computation (childutils)
; The below sample eventlistener section shows all possible
; eventlistener subsection values, create one or more 'real'
; eventlistener: sections to be able to handle event notifications
; sent by supervisor.

;[eventlistener:theeventlistenername]
;command=/bin/eventlistener    ; the program (relative uses PATH, can take args)
;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
;numprocs=1                    ; number of processes copies to start (def 1)
;events=EVENT                  ; event notif. types to subscribe to (req'd)
;buffer_size=10                ; event buffer queue size (default 10)
;directory=/tmp                ; directory to cwd to before exec (def no cwd)
;umask=022                     ; umask for process (default None)
;priority=-1                   ; the relative start priority (default -1)
;autostart=true                ; start at supervisord start (default: true)
;autorestart=unexpected        ; restart at unexpected quit (default: unexpected)
;startsecs=10                  ; number of secs prog must stay running (def. 1)
;startretries=3                ; max # of serial start failures (default 3)
;exitcodes=0,2                 ; 'expected' exit codes for process (default 0,2)
;stopsignal=QUIT               ; signal used to kill process (default TERM)
;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
;user=chrism                   ; setuid to this UNIX account to run the program
;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
;stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
;stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
;stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
;stdout_events_enabled=false   ; emit events on stdout writes (default false)
;stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
;stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
;stderr_logfile_backups        ; # of stderr logfile backups (default 10)
;stderr_events_enabled=false   ; emit events on stderr writes (default false)
;environment=A=1,B=2           ; process environment additions
;serverurl=AUTO                ; override serverurl computation (childutils)
; The below sample group section shows all possible group values,
; create one or more 'real' group: sections to create "heterogeneous"
; process groups.

;[group:thegroupname]
;programs=progname1,progname2  ; each refers to 'x' in [program:x] definitions
;priority=999                  ; the relative start priority (default 999)
; The [include] section can just contain the "files" setting.  This
; setting can list multiple files (separated by whitespace or
; newlines).  It can also contain wildcards.  The filenames are
; interpreted as relative to this file.  Included files *cannot*
; include files themselves.

[include]
files = /etc/supervisord.d/*.ini

增加进程守护配置

注意第③步最后一行的include，这里是配置需要守护进程的文件所在位置的配置，演示这里配置存放位置为/etc/supervisord.d/，这个目录下存放的就是各进程的配置文件ini，ini文件（www.xxxxx.cn.ini）的示例内容如下，标红的内容即需要修改的：

Plain Text

[program:www.xxxxx.cn]

process_name=%(program_name)s_%(process_num)02d

command=/www/wwwroot/xxxxxx/daemon.sh /www/server/php/74/bin/php

autostart=true

autorestart=true

user=www

numprocs=1

redirect_stderr=true

stdout_logfile_maxbytes=10MB

stdout_logfile_backups=5

stdout_logfile=/www/wwwroot/xxxxxxxxxx/storage/logs/worker.log

注意标红内容的含义：

/path/to/daemon.sh daemon.sh文件位置

/path/to/php php执行文件位置

/path/to/storage/logs/worker.log 日志位置

启动或者重启supervisor

启动 supervisord -c /etc/supervisord.conf

重启 supervisorctl restart 子进程（子进程就是第斯不中ini的内容里面的www.xxxx.cn）

查看运行状态

查看状态 supervisorctl status

这事到后台查看守护进程是否是绿色如果不是可以稍等一段时间查看，或者检查配置以及守护进程的运行状态是否正常

至此后端配置完成
H5端部署

H5配置主要是包装node版本正确的情况下，配置接口域名后，运行npm命令生成文件：

Node版本官方要求是12.14.0，实验证明当前使用的14.19.1也可以正常使用，建议使用官方要求版本

配置接口域名：找到文件vue.config.js大约115行，改成需要的域名

之后一次运行：npm install（安装依赖）、npm run dev（运行本地演示）、npm run build（打包文件），之后得到的文件放到/addons/yun_shop目录下，注意这个目录不仅有h5的文件，还有部分后台的文件，一定要备份，只替换static下的app目录和index.html即可，其他的文件不能动，之后访问即可
四、小程序部署
1、小程序使用微信开发者工具打开，修改配置
找到根目录host.js文件修改如下的标红部分
module.exports = {
host: “https://www.xxxx.cn/“,
uniacid: “4“,
adBrightid: “”,
adBrightDomain: “”,
};
查看演示，如果是一些渠道获得的小程序源码，可能会出现如下的错误提示：

这个问题的解决方式是找到错误中提到的index.json文件修改引用对应组件的路径修改层级即可修复，../../../../ 引用层级不准确无法定位到对应的文件，所有会出现找不到的问题，注意即可（注意并不是一处，是有很多处类似的问题）
3、如果做二次开发增加了一些东西可能会出现包过大的情况，这种情况一般建议是减少不必要的文件，或者是一些静态资源可以远程已用不要放到小程序文件等。
4、注意小程序使用前需要登录小程序管理设置一些URL、备案等等，这里不做过多的说明，参考小程序官方的说明即可；但是需要主要的是，使用小程序之前要设置隐私服务内容声明，否则会出现如下的错误：