★ FEATURED ARTICLE 一、前言在之前的系列文章中我写了 LikeShop 多商户版的部署配置、数据迁移和权限体系。这一篇回到单商户标准版把宝塔一键部署和小程序对接的完整流程走一遍。单商户标准版的部署和高级版、多商户版有一个关键区别PHP 版本要求是 7.27.4推荐 7.2和高级版的 PHP 8.0 完全不同。用错版本会直接导致安装失败或运行时报错。除此之外单商户标准版的部署流程相对简单宝塔的一键部署功能可以省去大部分手动配置。这篇文章按照实际部署顺序把环境准备、一键部署、数据库配置、运行目录与伪静态、小程序对接和常见问题排查完整拆开讲清楚。二、部署前的环境准备2.1 运行软件版本选择在宝塔面板的「软件商店」中安装以下软件软件版本要求Nginx 或 Apache不限制PHP7.27.4推荐 7.2MySQL5.7推荐 5.7官方特别提示使用推荐的版本可减少兼容性导致的问题避免不必要的环境报错。2.2 PHP 扩展检查安装 PHP 7.2 后进入「设置」→「安装扩展」确认以下扩展已启用fileinfo安装环境检测会检查这个扩展redis建议一并安装用于缓存opcache生产环境建议开启提升 PHP 执行效率如果安装时提示扩展未通过在 PHP 设置的扩展安装页面找到对应扩展点击安装即可。2.3 源码包准备从 Gitee 下载 LikeShop 单商户标准版源码包地址是https://gitee.com/likeshop_gitee/likeshop。下载完成后如果压缩包不是 zip 格式的需要解压后重新打包成 zip 格式否则宝塔的一键部署功能无法识别。三、宝塔一键部署实战3.1 一键部署操作步骤在宝塔面板的「软件商店」→「一键部署」→「导入项目」中上传 zip 包按提示填写域名和数据库信息点击「提交」即可自动完成部署。操作流程如下第一步点击「软件商店」→「一键部署」→「导入项目」选择下载好的 zip 文件包。第二步点击列表中的「一键部署」填写部署的域名按产品填写其它信息点击「提交」。第三步复制并保存系统显示的信息数据库名、用户名、密码等下一步安装程序时需要用到。第四步打开上一步显示的访问站点进入安装界面。3.2 安装程序配置进入安装界面后按以下步骤操作阅读许可协议点击「我已阅读并同意」。环境监测检查 PHP 版本、扩展、目录权限。如果没有通过按要求调整后点击「继续」。目录权限问题一般设置为 www 用户即可如果不行给目录 777 权限隐藏文件缺失很多人会把项目解压后重新打包遗漏了隐藏文件按提示创建文件即可PHP 扩展缺失点击「软件商店」→ 找到对应 PHP 版本 →「设置」→「安装扩展」填写数据库信息填写数据库名、用户名、密码以及超级管理员的账号密码。点击「继续」后如果安装报错请仔细检查信息是否填写正确。3.3 sql-mode 配置如果安装提示“请在 mysql 配置文件修改 sql-mode 添加 NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION”需要在 MySQL 配置文件中修改后重启 MySQL。在宝塔的「软件商店」→「MySQL 5.7」→「设置」→「配置修改」中找到sql-mode行修改为sql-modeNO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION修改后重启 MySQL 服务。注意上面的配置已经去掉了ONLY_FULL_GROUP_BY这是关键。安装成功后点击「进入管理平台」即可进入管理后台。四、运行目录与伪静态配置虽然一键部署会自动配置运行目录和伪静态但了解这些配置的原理有助于排查问题。4.1 运行目录单商户标准版的运行目录必须指向server/public。在宝塔中进入站点设置 →「网站目录」→「运行目录」选择server/public。4.2 伪静态规则如果一键部署后部分页面出现 404检查伪静态规则是否正确。LikeShop 的标准伪静态规则是location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s/$1 last; } }注意s/$1中间有一个斜杠这是关键。在宝塔中配置后必须点击「重载 Nginx」——只保存不重载规则不会立即生效。4.3 HTTPS 证书部署如果项目准备上线小程序需要使用 HTTPS 证书。宝塔配置 HTTPS 证书比较方便回到网站列表选择设置点击「SSL」→「Let‘s Encrypt」选上选项点击「申请」即可。申请成功后关闭窗口就可以使用 HTTPS 访问网站了。五、小程序对接5.1 小程序配置的重要性官方文档明确说明小程序配置一定要配置否则可能会造成「微信登录」「微信支付」等功能无法使用。5.2 配置小程序 ID 和密钥打开并登录微信小程序官网后台https://mp.weixin.qq.com/点击「开发管理」→「开发设置」分别复制 AppID小程序ID和 AppSecret小程序密钥。关于 IP 白名单可以不设置 IP 白名单如果设置了 IP 白名单要填写服务器的正确 IP 地址。打开并登录商城后台进入「渠道」→「小程序设置」填写从微信小程序官网后台复制的 AppID 和 AppSecret然后点击确定保存。5.3 配置服务器域名在商城后台的「渠道」→「小程序设置」中找到服务器域名分别复制以下域名request 合法域名socket 合法域名uploadFile 合法域名downloadFile 合法域名udp 合法域名tcp 合法域名打开微信小程序官网后台点击「开发管理」→「开发设置」→「修改」找到服务器域名将上述域名一一复制到对应选项中点击「保存并提交」。特别提醒如果使用了对象存储 OSS 或其他图片代理域名也需要一并添加否则和域名相关的功能可能存在异常。5.4 配置业务域名如果小程序中需要通过 webview 打开非本系统链接如导航链接需要额外配置业务域名。操作步骤第一步在商城后台的「小程序设置」中点击「下载校验文件」。第二步将校验文件上传到项目目录的server/public路径下注意不要修改文件名称。第三步在微信小程序官网后台点击「开发管理」→「开发设置」→「修改」将业务域名复制到对应选项中点击「保存」。5.5 编译小程序打开 HBuilderX 编辑器使用「APP 开发版」。打开项目时一定要打开uniapp目录不要选择外层目录。设置服务端地址打开项目根目录找到.env.production.example文件创建副本后去掉.example后缀修改其中的域名地址为服务端部署的域名地址。不要使用本地地址修改完成后按 CtrlS 保存。重新设置 DCloud AppID第一次使用 LikeShop 时需要重新设置 DCloud AppID找到manifest.json文件点击「重新获取」→「继续」。编译与上传打开项目的app.js目录点击「发行」→「小程序-微信仅适用于 uni-app」填写好小程序名称和 AppId然后点击「发行」。编译完成后点击「上传」→「确定」→「上传」小程序。提交审核登录微信小程序管理后台点击「版本管理」找到刚才发布的版本点击「提交审核」。六、常见问题与排查6.1 页面 404官方文档明确说明404 错误主要有两个原因1. 没有设置伪静态或者伪静态设置错误2. 网站路径设置错误。排查顺序先查运行目录是否为server/public再查伪静态规则中s/$1的斜杠是否正确最后确认 Nginx 已重载。6.2 sql-mode 报错按第 3.3 节的方法修改 MySQL 的 sql-mode 配置重启 MySQL 后重试。6.3 小程序编译报错如果编译时报错“请参考官方文档在 .env 文件下配置请求域名”说明环境变量文件没有正确配置。检查.env.production文件是否存在、域名是否正确填写、文件是否已保存。6.4 微信登录报错如果小程序登录报错优先排查IP 白名单是否设置了 IP 白名单服务器 IP 是否填写正确JS 安全域名是否配置了 JS 安全域名小程序配置小程序 ID 和密钥是否填写正确6.5 定时任务跑不起来定时任务配置中think文件路径必须是绝对路径执行周期设为每分钟一次php /www/wwwroot/likeshop/server/thinkcrontab七、总结LikeShop 单商户标准版的部署流程可以概括为四条线环境准备PHP 7.27.4推荐 7.2MySQL 5.7确认 fileinfo、redis、opcache 扩展已安装。宝塔一键部署导入 zip 包 → 填写域名和数据库信息 → 提交 → 进入安装程序 → 填写数据库信息 → 安装完成。运行目录与伪静态运行目录指向server/public伪静态规则rewrite ^(.*)$ /index.php?s/$1 last;配置后必须重载 Nginx。小程序对接配置小程序 ID/密钥 → 配置服务器域名 → 配置业务域名 → 编译上传 → 提交审核。把这四个环节的配置做对单商户标准版就能顺利跑通。剩下的就是运营和二开的事了。
阅读完成 · 觉得有帮助？
