PHPlivechat 无限坐席客服系统部署指南：Apache+PHP5.6 与安卓 APP 绑定

简介这份资源是2021年12月修复版的PHPlivechat在线客服系统源码包面向需要自建客服渠道的中小企业、站长及PHP开发者解决第三方客服平台坐席受限、数据不可控的问题。系统支持无限坐席并附带安卓手机APP客服端方便客服人员脱离电脑随时接待访客。压缩包共451个文件约133.83MB以100个php核心程序、122个js交互脚本、110个png界面素材为主另含html模板、css样式、mp3提示音、字体图标及sql数据库文件并附有apk安装包结构完整可直接部署。目前已有1104人学习下载。资源内含宝塔Linux与Windows环境搭建教程覆盖Apache2.4.41与PHP5.6以上配置、站点创建、源码上传解压及安装向导无需手动修改数据库信息同时提供APP扫码绑定后台QR码、添加服务器与登录表单的完整说明并附客服专属聊天链接便于快速上线与二次开发。1. PHPlivechat 这套无限坐席客服系统到底适合谁上手如果你正在找一个能自己部署、不按坐席数收费、还带安卓客服端 APP 的在线客服系统PHPlivechat 这套 2021 年 12 月修复版值得花半小时试一遍。它的核心卖点很直接源码部署在你自己服务器上坐席数量不设上限访客端通过一个专属链接就能发起对话客服除了在网页后台接待还能装一个安卓 APK 在手机上扫码绑定、随时接管会话。整套东西不依赖第三方 SaaS数据落在自己库里对预算敏感又想掌控数据的中小团队、外包建站公司、以及需要给客户交付独立客服模块的开发者来说落地成本比买商业授权低得多。适合的人群很明确会用宝塔面板建站、能配 Apache 和 PHP 环境、看得懂安装向导填数据库信息的人。不适合完全没碰过服务器、指望一键解压就能跑起来的新手——它虽然号称免改数据库配置但环境版本、目录权限、伪静态这几处该踩的坑一个不少。下面按「环境怎么搭 → 源码怎么装 → APP 怎么绑 → 坑在哪 → 怎么验证」的顺序拆开讲每一步都落到能直接抄的参数和命令上。2. 环境与部署Apache 2.4 PHP 5.6 的宝塔落地参数2.1 为什么锁定 Apache 2.4.41 和 PHP 5.6 以上这套源码是典型的 PHP 5.x 时代产物目录里那堆gumby.css、jquery-ui-1.10.3.custom.css、font-awesome.min.css说明前端用的是老一代 UI 框架后端对 PHP 版本有隐性依赖。PHP 7.x 虽然多数语法能跑但部分老函数比如某些mysql_*风格调用或ereg残留在 7.0 之后被移除直接白屏。所以环境选型上PHP 5.6 是最稳的基线Apache 2.4.41 是官方教程里点名的版本配合 mod_rewrite 处理伪静态。宝塔面板里装环境很快但要注意宝塔默认可能给你装 PHP 7.4 或 8.0装完这套系统大概率报错。正确做法是在「软件商店」里单独装一个 PHP 5.6然后在站点设置里把 PHP 版本切过去。Apache 也要确认是 2.4 系列Nginx 不是不能跑但伪静态规则要自己转官方教程只给了 Apache 的用 Nginx 属于给自己加活。2.2 宝塔建站与数据库配置的具体步骤先建站点再建数据库顺序别反。宝塔里「网站 → 添加站点」域名填你自己的PHP 版本选 5.6数据库选 MySQL 5.6 或 5.7 都行别上 8.0认证插件变了老代码连不上。# 宝塔 SSH 里确认 PHP 5.6 和 Apache 都在跑 bt default # 查看宝塔面板默认信息 systemctl status httpd # 确认 Apache 运行 php -v # 如果多版本用 /www/server/php/56/bin/php -v 指定建站完成后宝塔会给你数据库名、用户名、密码这三样记下来安装向导要填。源码上传到站点根目录后解压注意解压出来的目录层级——有些包解压后多套一层文件夹要把里面的内容挪到根目录否则访问域名会看到目录列表而不是安装页。# 上传源码后解压假设压缩包在 /www/wwwroot/你的域名/ cd /www/wwwroot/你的域名/ unzip phplivechat.zip # 如果解压后是 phplivechat/ 子目录把内容移上来 mv phplivechat/* . mv phplivechat/.* . 2/dev/null rmdir phplivechat # 给目录写权限安装向导要写配置文件 chown -R www:www /www/wwwroot/你的域名/ chmod -R 755 /www/wwwroot/你的域名/这几条命令的逻辑unzip解压mv把子目录内容提到根目录.*处理隐藏文件chown把属主改成 www 用户Apache 运行身份chmod 755保证目录可读可执行、文件可写。参数上755 是目录权限的常见值如果安装时提示「无法写入配置文件」临时给 777 排查装完再改回 755。2.3 安装向导与伪静态规则访问你的域名正常会跳到安装页面。填数据库地址一般 localhost、库名、用户名、密码然后设后台管理员账号密码点安装。这一步源码里不需要你手动改数据库配置文件安装向导会自己写——这是这套修复版相比老版本省事的地方。Apache 的伪静态规则要在宝塔站点设置里贴进去否则客服链接和后台路由会 404IfModule mod_rewrite.c RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?$1 [L,QSA] /IfModuleRewriteEngine On开启重写两个RewriteCond表示「请求的不是真实文件、也不是真实目录」才走重写RewriteRule把请求交给 index.php 处理。[L,QSA]里 L 是最后一条规则、QSA 是保留原始查询串。这段规则解决的是「除首页外其他页面打不开」的典型问题装完不配伪静态后台登录后点任何菜单都可能 404。3. 手机 APP 客服端绑定扫码流程与后台 QR 码位置3.1 安卓 APK 的安装与服务器添加逻辑资源里带的客服管理APP.apk是安卓客服端装到手机上后不是直接登录而是先「添加服务器」再绑定。这个设计的好处是一个 APP 可以管多个部署了 PHPlivechat 的站点适合同时给多个客户维护系统的开发者。安装 APK 时安卓会提示「未知来源」允许即可。打开 APP 后界面里有个「添加新的服务器」入口点进去会让你扫码或手动填地址。这里的关键是必须用 APP 自带的扫码功能不要用手机系统相机扫因为系统相机只会识别成文本不会触发 APP 的绑定逻辑。3.2 后台 QR 码在哪、怎么扫、绑定后怎么登录QR 码在「在线客服系统 WEB 管理端后台」里登录网页后台后找绑定/移动端相关的入口页面上会显示一个二维码。用 APP 扫这个码APP 会自动把服务器地址、绑定令牌写进去。APP 绑定流程照着点 1. 打开客服管理 APP 2. 点「添加新的服务器」 3. 点扫码按钮对准后台的 QR 码 4. 扫描成功后给服务器起个名字中英文都行比如「公司客服」 5. 点保存 6. 点进这个服务器填「登录表单」——就是你的客服账号密码 7. 登录后即可在手机上接待访客第 4 步起名字是纯本地标识不影响服务端。第 6 步的登录表单用的是你在网页后台建的客服账号不是管理员账号除非你把管理员也设成客服。如果扫码后提示「绑定失败」九成是后台地址用了内网 IP 或带端口APP 在外网访问不到——确保 QR 码里的地址是公网可访问的域名。3.3 访客端专属链接的用法访客发起对话的入口是你的域名/php/app.php?widget-mobile这个链接可以直接嵌到网站里做浮动客服按钮也可以单独发给客户。widget-mobile这个参数说明它是移动端优化的 widget 样式PC 端访客访问同一个链接也能用只是布局偏移动。!-- 嵌到网站里的浮动客服按钮示例 -- script (function(){ var iframe document.createElement(iframe); iframe.src https://你的域名/php/app.php?widget-mobile; iframe.style.cssText position:fixed;right:20px;bottom:20px;width:60px;height:60px;border:none;z-index:9999;; document.body.appendChild(iframe); })(); /script这段 JS 动态创建一个 iframe 指向客服链接固定在右下角。参数right/bottom控制位置width/height控制大小z-index保证不被其他元素盖住。实际用时建议把 iframe 尺寸调大或改成点击展开60x60 只是个入口图标的大小。注意跨域问题如果客服系统和你的主站不同域iframe 通信会受限常见做法是把客服系统部署在同域的子目录下。4. 避坑与排查装完打不开、扫码绑不上的五类翻车4.1 访问域名显示目录列表或源码被下载现象打开域名看到文件列表或者浏览器直接下载了 php 文件。原因Apache 没正确解析 PHP或者站点根目录指错了。解决宝塔站点设置里确认「运行目录」是源码所在目录PHP 版本选的是 5.6然后重启 Apache。如果还是下载文件检查 Apache 的 PHP 模块有没有加载httpd.conf里应该有LoadModule php5_module之类的行。4.2 安装向导填完数据库点安装没反应现象填了库名密码点安装按钮页面刷新但没进展或者报 500。原因数据库连接信息错、目录没写权限、PHP 版本过高。解决先用宝塔的 phpMyAdmin 确认库能连上再chmod -R 777临时放开权限试一次最后确认 PHP 是 5.6 不是 7.x。血泪经验是 PHP 版本这一条很多人卡半天最后发现是宝塔默认给了 7.4。4.3 后台能登录但点菜单全 404现象登录后台成功点任何功能都跳 404。原因伪静态没配。解决把 2.3 节那段 Apache 规则贴到站点伪静态设置里保存后清浏览器缓存重试。用 Nginx 的话要自己转规则核心是把非真实文件/目录的请求转发给 index.php。4.4 APP 扫码提示绑定失败现象APP 扫码后转圈然后报错。原因QR 码里的地址是内网 IP、带非标准端口、或 HTTPS 证书有问题。解决确保后台用公网域名访问QR 码生成的就是这个域名如果用了 HTTPS证书要有效自签证书 APP 可能拒绝。常见做法是先用 HTTP 域名绑一次确认流程通再上 HTTPS。4.5 手机 APP 登录后收不到访客消息现象APP 绑定成功、登录成功但访客发消息手机没提醒。原因APP 后台被杀、推送权限没给、或服务端消息轮询间隔问题。解决给 APP 开自启动和通知权限安卓省电策略里把它设为「不优化」。这套系统的移动端消息机制偏轮询不是长连接推送所以 APP 必须保持后台存活这是它的边界不是 bug。5. 验证部署是否真的可用三条自检命令与一个压测习惯装完别急着交付先跑一遍自检。第一条确认 PHP 版本和关键扩展/www/server/php/56/bin/php -m | grep -E mysql|curl|gd|mbstringmysql是数据库连接、curl用于外部请求、gd处理图形验证码、mbstring处理中文。缺哪个就在宝塔 PHP 5.6 的设置里装哪个扩展装完重启 PHP。第二条确认伪静态生效curl -I https://你的域名/php/app.php?widget-mobile返回 200 说明访客链接可达返回 404 说明伪静态或文件路径有问题返回 500 说明 PHP 报错去宝塔的网站日志里看具体错误行。第三条确认数据库写入正常。在后台随便改一个设置保存然后查库SELECT * FROM 你的配置表 ORDER BY id DESC LIMIT 1;能查到刚改的记录说明安装向导写的配置和数据库连接都正常。查不到就是权限或连接问题回到 4.2 排查。我自己的习惯是每次部署完这套系统先用手机 APP 发一条测试消息、再用访客链接回一条确认双向通。从那以后我每次交付前都强制走一遍「PHP 扩展 → 伪静态 → 双向消息」这三步比装完就交省心得多。这套 PHPlivechat 修复版的价值在于免改配置、带移动端、坐席不限边界在于它是个老架构、依赖 PHP 5.6、移动端靠轮询接受这两点它就是个能长期跑的独立客服方案。希望帮到你。本文还有配套的精品资源点击获取