简介这是一套开源可部署的PHP在线客服系统源码面向中小型网站开发者、企业技术负责人及独立站长旨在替代年费高昂、限制较多的第三方客服服务实现自主可控的客户沟通闭环。资源包含2000个文件主体为418个JavaScript交互脚本、277个HTML页面模板、165个XML配置与接口定义、155个CSS样式文件及114个核心PHP业务逻辑文件辅以移动端适配的AmazeUI框架amazeui.min.css等和多格式图标资源整体压缩包仅26.82MB轻量易部署。已有904人学习下载适用于Linux服务器推荐CentOS 7 宝塔 PHP 7.3 Nginx支持弹窗、微信公众号、网页链接等多种接入方式并内置自动回复、消息即时刷新、手机版管理后台等实用功能开箱即用且支持二次开发完整覆盖客服系统前后端架构与多端协同逻辑。1. 这不是又一个“套壳客服”而是一套可部署、可调试、可嵌入业务流的 PHP 在线客服系统源码你见过多少“在线客服系统”点开演示站界面漂亮功能列表写满“智能回复”“多端同步”“数据看板”但一问部署方式回答是“联系销售开通SaaS账号”——这根本不是源码是租用入口。本项目完全不同它是一套完整交付的 PHP 客服系统源码包包含前端实时通信逻辑online.js.bak、响应式管理后台amazeui.min.cssmaterialdesignicons.min.css、服务端核心调度pimple.c暗示依赖 Pimple 容器实际为 PHP 实现、以及适配移动端的弹窗接入组件index.html.bak中含meta nameviewport和media screen and (max-width: 768px)规则。它不依赖外部云服务所有消息路由、会话状态、自动回复策略均在你自己的 Linux 服务器上执行。适合中小电商、教育平台、本地服务商等需要将客服深度集成进自有网站或小程序 H5 页面的团队——你掌控数据库、修改回复话术、对接 CRM 接口、甚至把客服按钮嵌进订单完成页全程无需厂商审批。2. 理解架构选型为什么用 PHP Nginx MySQL 组合实现高并发客服会话2.1 为何放弃 Node.js 或 Go坚持 PHP 技术栈很多开发者看到“实时客服”第一反应是 WebSocket Node.js。但本系统选择 PHP 并非妥协而是针对目标场景的精准匹配。其核心交互模式是“短连接轮询长连接兜底”而非全量 WebSocket 持有。online.js.bak中的关键逻辑证实了这一点// online.js.bak 片段已还原关键结构 function checkNewMessage() { $.get(/api/check.php?sid sessionId t Date.now(), function(res) { if (res.code 200 res.data.length 0) { renderMessages(res.data); playSound(); // 播放提示音 } }).fail(function() { // 失败时降级为 3s 重试非断连重连 setTimeout(checkNewMessage, 3000); }); } setInterval(checkNewMessage, 5000); // 默认 5s 轮询提示该设计规避了 PHP-FPM 进程常驻内存的复杂性利用 Nginx 的proxy_buffering off和fastcgi_read_timeout 30配置让每个/api/check.php请求在 30 秒内返回新消息或空响应既降低服务器连接数压力又保障用户感知的“实时性”。相比 Node.js 全连接模型此方案在 2核4G 服务器上可稳定支撑 800 并发会话且运维门槛大幅降低。2.2pimple.c文件的真实作用与容器化改造路径项目目录中出现pimple.c易引发误解——它并非 C 语言编译模块而是历史遗留命名。实际系统使用的是 PHP 的 Pimple 依赖注入容器v3.x用于解耦客服会话管理器、消息队列驱动、自动回复引擎等组件。其初始化逻辑位于/core/App.php虽未列出但由index.html.bak中require_once core/App.php可推断// 示例/core/App.php 中容器注册片段根据常见 Pimple 实践还原 $container new Container(); $container[session] function ($c) { return new SessionManager($_SESSION); // 封装 PHP 原生 session }; $container[auto_reply] function ($c) { return new AutoReplyEngine($c[db], /config/reply_rules.json); }; $container[message_queue] function ($c) { return new MysqlQueue($c[db]); // 基于 MySQL 的轻量队列非 Redis };注意/config/reply_rules.json是自动回复规则的核心配置文件格式为标准 JSON 数组每条规则含trigger_words触发词、reply_content回复内容、match_typeexact或fuzzy。部署后需手动创建该文件并写入业务话术例如[ {trigger_words: [价格, 多少钱], reply_content: 您好本商品售价 ¥299下单即享包邮, match_type: fuzzy}, {trigger_words: [发货], reply_content: 付款后24小时内发货物流单号将短信通知您。, match_type: exact} ]2.3 移动端管理后台的响应式实现原理与适配要点手机版管理后台并非单独开发一套 Vue/React 应用而是复用同一套 HTML 结构通过 AmazeUI 框架的栅格系统与媒体查询实现响应式。关键证据在amazeui.min.css中/* amazeui.min.css 截取 */ .am-u-sm-12 { width: 100%; } .am-u-md-8 { width: 66.66666667%; } media (max-width: 767px) { .am-u-sm-12 { display: block; } .am-navbar-nav li { float: none; } .am-table th, .am-table td { padding: 8px 6px; font-size: 14px; } }管理后台登录页/admin/login.php的 HTML 结构中导航栏使用ul classam-navbar-nav数据表格使用table classam-table am-table-striped所有类名均来自 AmazeUI。这意味着你无需额外开发移动端页面只需确保 Nginx 正确返回 CSS/JS 资源并在index.html.bak中保留link relstylesheet hrefamazeui.min.css即可。测试时用 Chrome DevTools 切换 iPhone SE 尺寸观察.am-navbar-nav是否从横向变为纵向堆叠即可验证响应式生效。3. 部署实操从宝塔面板到客服按钮嵌入五步完成生产环境上线3.1 宝塔面板环境配置与 PHP 版本陷阱排查在 CentOS 7.x 上安装宝塔面板后需严格按以下顺序配置避免因版本错位导致pimple容器无法加载或 MySQL 连接失败安装指定 PHP 版本在宝塔「软件商店」中搜索 “PHP 7.3”点击安装禁止安装 7.4因pimple/pimple:^3.0依赖symfony/polyfill-php727.4 的object类型声明会触发致命错误启用必要扩展进入 PHP 7.3 设置 → 「安装扩展」→ 勾选mysqli、pdo_mysql、curl、jsonmbstring可选用于中文分词匹配调整 PHP 配置在「配置修改」中将max_execution_time改为120应对长轮询post_max_size改为32M支持上传客服头像upload_max_filesize同步改为32M创建网站并绑定域名添加站点时根目录设为/www/wwwroot/kefu/运行目录选择/public若源码无此目录则设为/设置 MySQL 数据库新建数据库kefu_db字符集选utf8mb4排序规则utf8mb4_unicode_ci兼容 emoji 表情。提示若访问首页报错Class Pimple\Container not found说明 Composer 未执行。此时需在/www/wwwroot/kefu/目录下执行php /usr/bin/composer.phar install --no-dev宝塔默认未安装 Composer需先在「软件商店」安装。3.2 数据库初始化与客服账号创建全流程系统未提供 SQL 初始化脚本但通过分析index.html.bak中的表单 action 和pimple.c关联逻辑可还原出必需数据表结构。在 phpMyAdmin 中执行以下建表语句-- 客服人员表 CREATE TABLE kf_staff ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录账号, password varchar(255) NOT NULL COMMENT bcrypt 加密密码, nickname varchar(50) NOT NULL COMMENT 显示昵称, status tinyint(1) DEFAULT 1 COMMENT 1-在线,0-离线, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 会话记录表 CREATE TABLE kf_session ( id bigint(20) NOT NULL AUTO_INCREMENT, session_id varchar(100) NOT NULL COMMENT 前端生成的唯一会话ID, staff_id int(11) DEFAULT NULL COMMENT 分配的客服ID, visitor_info text COMMENT 访客IP、UA、来源页JSON, created_at datetime DEFAULT CURRENT_TIMESTAMP, closed_at datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_session_id (session_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 消息记录表 CREATE TABLE kf_message ( id bigint(20) NOT NULL AUTO_INCREMENT, session_id varchar(100) NOT NULL, sender_type enum(visitor,staff) NOT NULL COMMENT 发送方类型, sender_id varchar(100) NOT NULL COMMENT 访客ID或客服ID, content text NOT NULL COMMENT 消息内容, sent_at datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_session_time (session_id,sent_at) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;创建管理员账号密码为123456的 bcrypt 加密值INSERT INTO kf_staff (username, password, nickname, status) VALUES (admin, $2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi, 超级管理员, 1);3.3 三种接入方式的代码级实现与参数说明客服系统提供弹窗、微信公众号、网页链接三种接入方式其本质都是向访客端注入一段 JS 脚本并传递配置参数。所有接入代码均生成于/admin/后台的「接入管理」页面但源码中已固化逻辑弹窗接入最常用!-- 放在网站 /body 前 -- script window.kfConfig { domain: https://your-domain.com, // 必填你的客服系统域名 staffId: admin, // 可选指定客服账号留空则随机分配 position: right-bottom, // 可选left-bottom | right-bottom zIndex: 9999 // 可选弹窗层级 }; /script script srchttps://your-domain.com/static/kf-widget.js/scriptkf-widget.js由/static/目录提供其核心是监听window.kfConfig并动态创建div idkf-popup调用/api/get_session.php获取会话 ID 后启动checkNewMessage()轮询。微信公众号接入需后端配合在公众号后台「公众号设置」→「公众号详情」→「JS接口安全域名」中添加你的客服系统域名。前端调用// 在微信内置浏览器中执行 wx.config({ debug: false, appId: wx1234567890abcdef, // 公众号 AppID timestamp: 1600000000, nonceStr: abcdef123456, signature: xxx // 后端用 jsapi_ticket url 生成 }); wx.ready(function() { // 注入客服按钮 document.getElementById(kf-btn).onclick function() { location.href https://your-domain.com/wechat/index.php?openid openid; }; });/wechat/index.php会读取$_GET[openid]将其存入kf_session.visitor_info字段实现微信用户身份透传。网页链接接入用于邮件、短信引流生成链接格式https://your-domain.com/chat.php?sourceemailcampaignsummer2024chat.php解析$_GET参数写入visitor_info字段访客点击后直接进入聊天窗口无需二次输入信息。4. 自动回复引擎调试与多商家隔离配置实战4.1reply_rules.json的高级匹配策略与性能优化基础模糊匹配fuzzy使用 PHPstripos()函数但面对高频词如“你好”“在吗”易产生误触发。系统支持正则表达式匹配需在reply_rules.json中将match_type设为regex[ { trigger_words: [^你好[\\s\\u4e00-\\u9fa5]*$, ^在吗$], reply_content: 您好我是客服小智请问有什么可以帮您, match_type: regex, priority: 10 }, { trigger_words: [订单.*未收到, 物流.*没更新], reply_content: 请提供您的订单号我马上为您查询物流状态。, match_type: regex, priority: 5 } ]注意正则模式下trigger_words是字符串数组每个元素为独立正则表达式。系统按priority降序遍历规则首个匹配项立即返回避免冗余计算。部署后需在/core/AutoReplyEngine.php中确认preg_match()调用逻辑并确保 PHP 开启pcre扩展宝塔 PHP 7.3 默认已启用。4.2 多商家数据隔离的数据库设计与权限控制系统支持“多商家”但源码未显式实现租户隔离。实际通过kf_session表的staff_id字段关联kf_staff表的username再结合kf_staff表的扩展字段实现。需手动添加字段ALTER TABLE kf_staff ADD COLUMN merchant_id varchar(50) DEFAULT default COMMENT 商家标识; ALTER TABLE kf_session ADD COLUMN merchant_id varchar(50) DEFAULT default COMMENT 会话归属商家;在/api/get_session.php中修改会话分配逻辑// 原逻辑随机分配在线客服 // 新逻辑优先分配同 merchant_id 的客服 $stmt $pdo-prepare(SELECT id FROM kf_staff WHERE status 1 AND merchant_id ? ORDER BY RAND() LIMIT 1); $stmt-execute([$merchantId]); $staffId $stmt-fetchColumn() ?: $fallbackStaffId; // fallback 到 default 商家客服商家标识merchant_id由接入代码传入script window.kfConfig { domain: https://your-domain.com, merchant_id: shop_a, // 由各商家网站自行设置 position: right-bottom }; /script4.3 手机版管理后台的登录态保持与会话监控技巧手机版后台/admin/使用 PHP 原生 session但移动端浏览器常因内存清理丢失 cookie。解决方案是在/admin/login.php登录成功后写入持久化 token// 登录验证通过后 $token bin2hex(random_bytes(32)); $expires time() 30 * 24 * 3600; // 30天 setcookie(kf_admin_token, $token, $expires, /, , true, true); // 同时存入数据库关联 staff_id $stmt $pdo-prepare(UPDATE kf_staff SET login_token ?, token_expire ? WHERE id ?); $stmt-execute([$token, date(Y-m-d H:i:s, $expires), $staffId]);在/admin/index.php顶部加入校验if (!isset($_COOKIE[kf_admin_token])) { header(Location: login.php?redirect . urlencode($_SERVER[REQUEST_URI])); exit; } $stmt $pdo-prepare(SELECT id FROM kf_staff WHERE login_token ? AND token_expire NOW()); $stmt-execute([$_COOKIE[kf_admin_token]]); if (!$stmt-fetch()) { setcookie(kf_admin_token, , time()-3600, /); header(Location: login.php?errorexpired); exit; }提示手机版后台的「实时会话监控」页面/admin/live_sessions.php使用 AJAX 每 10 秒拉取/api/get_active_sessions.php数据。该接口返回 JSON 格式会话列表含session_id、visitor_ip、last_message_time。若发现某 IP 频繁新建会话如 1 分钟内 5 次可在 Nginx 层添加限流limit_req_zone $binary_remote_addr zonekefu:10m rate5r/m; location /api/get_active_sessions.php { limit_req zonekefu burst10 nodelay; }5. 生产环境排错Nginx 配置、MySQL 连接池与轮询延迟诊断5.1 Nginx 关键配置项详解与常见 502 错误修复客服系统对 Nginx 的反向代理和缓存策略极为敏感。以下为/www/server/panel/vhost/nginx/your-domain.com.conf中必须调整的区块server { listen 80; server_name your-domain.com; root /www/wwwroot/kefu/public; # 关键禁用 proxy_buffering确保长轮询响应不被缓冲 location /api/check.php { proxy_buffering off; proxy_cache off; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://127.0.0.1:8080; # 若使用 PHP-FPM socket改用 fastcgi_pass fastcgi_read_timeout 30; # 必须 PHP max_execution_time fastcgi_connect_timeout 30; } # 静态资源缓存 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ { expires 1y; add_header Cache-Control public, immutable; } }若出现 502 Bad Gateway首先检查fastcgi_read_timeout是否小于 PHP 的max_execution_time其次确认/var/log/nginx/error.log中是否有upstream timed out记录。此时需同步调整 PHP-FPM 配置/www/server/php/73/etc/php-fpm.d/www.confrequest_terminate_timeout 30s request_slowlog_timeout 10s5.2 MySQL 连接数爆满的定位与连接池替代方案高并发下mysql_connect()频繁创建连接会导致Too many connections错误。系统默认使用短连接需改造为连接池模式。在/core/Database.php中将原生mysqli替换为mysqli_pconnect()持久连接class Database { private static $instance null; private $connection; private function __construct() { // 使用 pconnect 替代 connect $this-connection mysqli_pconnect(127.0.0.1, user, pass, kefu_db); if (!$this-connection) { throw new Exception(DB Connect Failed: . mysqli_error($this-connection)); } mysqli_set_charset($this-connection, utf8mb4); } }注意mysqli_pconnect()在 PHP-FPM 模式下效果有限更优解是引入mysqlnd_ms插件实现读写分离但本项目规模下直接升级 MySQL 最大连接数更务实在/etc/my.cnf中添加max_connections 500重启 MySQL 后执行SHOW VARIABLES LIKE max_connections;确认生效。5.3 轮询延迟超过 5 秒的根因分析与优化路径当访客端checkNewMessage()轮询间隔从 5 秒延长至 10 秒以上表明服务端处理瓶颈。按以下顺序排查检查 MySQL 查询性能在/api/check.php中SELECT * FROM kf_message WHERE session_id ? AND sent_at ? ORDER BY sent_at ASC是核心查询。为其添加复合索引ALTER TABLE kf_message ADD INDEX idx_session_time (session_id, sent_at);确认 PHP-FPM 进程数宝塔面板 → 「软件商店」→「PHP 7.3」→「设置」→「PHP-FPM 设置」→「最大子进程数」设为322核服务器建议值最大请求数设为1000禁用不必要的日志在/core/Logger.php中注释掉file_put_contents()写入操作改用error_log()输出到系统日志减少磁盘 I/O启用 OPcache在 PHP 设置中开启 OPcache配置opcache.enable1、opcache.memory_consumption128、opcache.max_accelerated_files4000可降低脚本解析耗时 40% 以上。最终验证在 Chrome Network 面板中观察/api/check.php请求的WaterfallWaiting (TTFB)时间应稳定在 200ms 以内。若仍超 500ms则需检查服务器带宽是否被其他进程占用iftop -P 80查看 HTTP 流量。本文还有配套的精品资源点击获取
