环境配置
约 1004 字大约 3 分钟
2025-06-05
注意事项
1.所有步骤请按文档操作,不懂原理请勿随意更改文档。 2.请勿使用微软的浏览器,可能有兼容性问题,当发现无法用的时候,换一个浏览器试试。
环境准备工作
安装redis
点击【软件商店】,搜索redis,然后点击【安装】,要使用redis6.x版本。
安装PHP扩展
安装
打开【软件商店】-【已安装】,找到项目使用的PHP版本,点击【设置】。
点击【安装扩展】,分别安装redis扩展和Swoole4扩展,安装完成以后,重启PHP。
运行环境检测
PHP版本
打开【终端】,登录服务器root账号,在终端输入php80 -v
后回车,检测该命令是否有效,有效时,终端会输出PHP版本信息。当显示“command not found”信息时,说明命令无效,要求宝塔面板为7.8以上版本,请升级宝塔。还是无效,修复宝塔面板。点击【首页】,右上角有【更新】和【修复】。 或者直接在终端输入php -v
后回车,输出的PHP版本信息是8.0,下面的操作部署也可以直接使用php
这个命令,如果使用的话,下面步骤全部使用这个命令。
PHP扩展
打开【终端】,登录服务器root账号,在终端输入php80 -m
后回车,这时会显示已经安装的PHP扩展,可以找到redis和swoole,说明PHP扩展安装正确。 如果没有找到,错误原因可能是在第一次安装PHP的时候,使用了编译安装,导致PHP扩展安装出问题。请重新卸载PHP,然后重新使用快速安装的方式安装PHP。接着在宝塔【首页】右上角点击【修复】。重新按之前的步骤安装。注意,除了swoole和redis扩展,别忘记安装fileinfo 扩展。
启动在线客服系统
点击【文件】,找到项目源码所在的server目录,找到.env文件,打开编辑,添加redis配置,有密码需要设置密码,无密码去掉“password = ”选项。
[CACHE]
driver = redis
host = 127.0.0.1
port = 6379
password = "123456"
点击【软件商店】-搜索“Supervisor”-点击【安装】-【安装插件】。 点击【文件】,找到项目源码所在的server目录(该目录下有think文件),复制“www/wwwroot/***/server",复制该目录路径,下面步骤需要用到。
点击【软件商店】-【已安装】-找到“Supervisor管理器”-【设置】,添加守护进程,填写名称,运行目录粘贴复制的项目server目录,启动命令输入php80 think swoole
,点击【确定】保存。
在列表中看到RUNNING状态,说明添加成功,如果状态不正常,请看上面步骤是否弄错。
配置在线客服域名
服务端配置
点击【网站】-【添加站点】,输入新的域名,设置PHP版本为纯静态,点击【提交】。这个域名是在线客服专用,请勿直接访问该域名。
点击【网站】,找到上个步骤添加的网站,点击【设置】-【SSL】-【Let‘s Encrtypt】,选择域名,点击【申请】证书,为该域名设置SSL(https)。
点击【反向代理】,在目标URL输入http://127.0.0.1:40211
,
点击【配置】,将以下配置新增到nginx的配置里,点击【保存】。
proxy_http_version 1.1;
proxy_connect_timeout 4s;
proxy_read_timeout 60s;
proxy_send_timeout 12s;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
wss地址配置
打开项目目录下server/.env文件,找到【PROJECT】项,添加在线客服域名,例ws_domain = wss://chat.xxxx.com
,其中wss://chat.xxxx.com
为在线客服的真实域名,然后保存即可。
看微信小程序发布文档,将在线客服域名添加使用的socket合法域名,不然微信小程序无法使用。