AI智能点餐配置实操:从零搭建扫码点餐系统
AI智能点餐配置的核心,是把点餐系统的后端服务、数据库和前端页面正确部署到服务器上,并让顾客扫码后能打开菜单、下单和支付。
本文按零基础也能照做的顺序,讲清环境准备、部署步骤、参数修改和验证方法,适用于自建扫码点餐后台或二次开发测试环境。
先确认服务器和软件环境
开始前需要一台能公网访问的服务器,以及一个已备案的域名(国内服务器必须,海外服务器可跳过备案但需注意访问速度)。
系统建议用 Linux,宝塔面板能省去大量命令行操作。
推荐最低配置:2 核 CPU、2GB 内存、40GB 系统盘。
如果使用 Docker 部署,内存建议 4GB 以上。
软件层面需要:
- Nginx 或 Apache 作为 Web 服务器
- MySQL 5.7 或 8.0(以点餐系统文档要求为准)
- PHP 7.4/8.0 或 Node.js 运行环境(取决于系统技术栈)
- Redis(部分系统用于缓存菜单和会话,非必须但建议安装)
在宝塔面板中,软件商店搜索并安装上述环境。
安装完成后,在“网站”中新建站点,绑定域名,并记下站点根目录路径,例如 /www/wwwroot/diancan。
上传源码并导入数据库
把点餐系统源码上传到站点根目录。
如果是压缩包,在宝塔文件管理器中右键解压。
解压后检查目录结构,通常应能看到 public、application 或 app 等入口目录。
接着创建数据库。
在宝塔“数据库”页面点击添加数据库,记下数据库名、用户名和密码。
然后导入系统自带的 SQL 文件,一般位于源码的 data 或 install 目录。
可通过 phpMyAdmin 导入,也可以在服务器命令行执行:
mysql -u 数据库用户名 -p 数据库名 < /www/wwwroot/diancan/data/install.sql
执行后输入数据库密码,无报错即表示导入成功。
进入 phpMyAdmin 查看表数量,确认与文档描述一致。
修改配置文件中的连接参数
数据库导入后,需要让系统知道数据库地址和账号。
找到源码中的配置文件,常见路径包括:
config/database.php.env文件application/database.php
用宝塔文件管理器编辑,把 hostname 改为 127.0.0.1,database、username、password 改成刚才创建的数据库信息。
如果系统使用 Redis,同样在配置中填写 Redis 地址和端口,默认 127.0.0.1:6379。
保存后,回到宝塔“网站”设置,把运行目录指向 public(如果框架要求),并设置伪静态规则。
以 Nginx 为例,在站点设置中粘贴框架对应的伪静态规则,保存后重载 Nginx。
配置域名、二维码和支付回调
顾客扫码点餐依赖二维码中的链接。
进入系统后台(通常访问 域名/admin 或 域名/install 完成初始化),在“门店设置”或“系统设置”中填写门店名称、营业时间、桌台数量和二维码域名。
二维码域名必须与当前访问域名一致,否则扫码后可能打不开。
如果系统支持在线支付,需要在支付配置中填写商户号、API 密钥和回调地址。
回调地址一般格式为 https://你的域名/pay/notify,必须能被外网访问。
配置完成后,在后台生成一张测试桌台二维码,用手机扫码验证菜单能否正常加载。
常见报错与避坑提醒
部署过程中容易卡在几个地方,提前注意能少走弯路:
- 打开页面显示 500 错误:先看宝塔网站错误日志,常见原因是数据库密码错误或
runtime目录没有写入权限。执行chmod -R 755 runtime并确保属主为www。 - 扫码后提示“网络异常”:检查域名是否解析到当前服务器,以及 Nginx 是否放行 80/443 端口。云服务器安全组也要放行。
- 后台登录后菜单空白:多为伪静态未生效或前端资源路径错误,检查站点伪静态配置和浏览器控制台报错。
- 修改配置文件后不生效:PHP 项目可能需要清除缓存,删除
runtime/cache目录后刷新页面。
验证配置是否真正可用
完成以上步骤后,按三个层面验证:第一,浏览器访问首页和后台登录页,确认无报错;
第二,手机扫码打开菜单,提交一笔测试订单,检查后台订单列表是否出现记录;
第三,如果接了支付,用支付平台提供的测试模式走一遍回调,确认订单状态能自动更新。
三项都通过,说明 AI智能点餐配置的基础链路已经跑通,后续再按门店实际菜品和桌台做数据录入即可。
如果验证中某一步失败,优先回看对应环节的日志和配置项,不要同时改动多个文件,避免问题叠加难以定位。