尧图网页设计 
简介朵米3.5客服系统源码2023正式版是一套面向企业级客户服务场景的全功能PHP解决方案适合需要搭建在线客服平台的技术人员、中小企业以及二次开发学习者。系统支持在线聊天、邮件、电话等多渠道接入具备智能分流、数据统计与客户行为分析能力能有效提升客服团队响应速度与服务质量。压缩包共2000个文件整体体积43.85MB以JS、HTML、CSS等前端界面资源为主辅以PHP业务逻辑、SQL数据库初始化脚本、Shell部署脚本以及DOCX格式的安装配置文档结构清晰便于快速定位。目前已有384人学习下载资源包含可直接部署的网站程序、数据库文件及《朵米3.5客服系统安装搭建配置文档》文档详细说明了CentOS7.6-7.9、宝塔面板、Nginx1.18-1.22、PHP7.1-7.3、MySQL5.6-5.7等运行环境的搭建步骤。无论是直接上线一套客服系统还是研究ThinkPHP架构下的多客服分流与消息处理机制这份源码都提供了完整的实践参考与二次开发基础。1. 朵米3.5客服系统源码2023正式版它是源码不是开箱即用的成品拿到朵米3.5客服系统源码2023正式版第一反应通常是“装完就能上线”真动手你会发现能打开安装向导只是最轻松的一步接下来要面对的是PHP版本、伪静态、消息推送延迟和客服分配策略这几道门槛。这套源码的本质是一个用PHP写成的在线客服工作台访客端和坐席端通过轮询或长连接交换消息会话内容、客服资料和机器人话术都沉淀在MySQL里。你需要给门户站配在线咨询或者想把老旧的留言板换成实时客服这个版本就能当底座尤其适合想读懂一套客服产品是如何设计的新手。它不会替你把未来需求都想好但它值得拆开看。2. 朵米3.5本地部署确认版本、选定环境和最小启动步骤2.1 解压后先别急着装用这份清单确认“正式版”成色我习惯把源码建站和纯二次开发分开。如果是把朵米3.5当现成网站部署最先确认的不是功能而是完整性。压缩包里如果少一个SQL文件或一段伪静态规则后面会花两倍时间补。所以解压后的第一件事是对着下面这张表逐项打勾。检查项常见位置为什么重要入口文件根目录 index.php 或 public/index.php少了它任何请求都打不进PHP安装SQLinstall/ 或 database/ 下的 .sql少了它连管理员表都没有应用配置application/config.php 或 data/config.php数据库账号、日志级别都靠它伪静态规则.htaccess / nginx.conf少了它后台所有菜单都是404可写目录runtime / tmp / upload少了写权限一登录就报错我在拿到一份压缩包之后最先执行的是这条查找命令两秒钟就能看出有没有SQL和伪静态文件cd /var/www/duomi find . -maxdepth 3 \( -iname *.sql -o -name .htaccess -o -name nginx.conf \) -type f这条命令把三层目录以内的.sql、.htaccess、nginx.conf都列出来。如果返回为空说明这份包被二次压缩过去掉了很多关键文件。再看PHP版本要求cat composer.json 2/dev/null || grep -r php --include*.json . | headcomposer.json里的require.php字段会写清支持范围如果包精简到没有composer.json就去安装向导的“环境检测”页面看版本提示。我见过有人不看这一步拿到包直接扔到PHP 8上面页面白屏两小时才开始排查。2.2 环境怎么选PHP 7.4、MySQL 5.7、Nginx 的兼容性逻辑这套源码是典型的php源码项目跑在 LNMP 上最省心。很多人习惯性装最新版PHP结果在PHP 8上翻车因为老框架里大量写法在8.x已经列为废弃或直接移除。我的固定组合如下组件推荐版本理由PHP7.4兼容性好pdo_mysql、mbstring扩展齐全老代码改动最小MySQL5.7utf8mb4支持稳定报表SQL语法兼容度高Nginx1.24 或 1.26伪静态规则好控制不开Apache也能跑Redis可选如果源码带消息队列模块再启用选择PHP 7.4还有一个原因它处于安全维护期既有社区插件支持又不像8.x那样对旧框架不友好。MySQL别用8.0倒不是不能用而是老SQL文件里如果有ENGINEMyISAM或者字符集混用在8.0下会冒出权限和排序规则的问题问题不大但很烦。2.3 最小启动步骤建库、导数据、改配置先把数据库建出来。如果SQL文件在database/目录下最小步骤如下mysql -uroot -p -e CREATE DATABASE duomi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p duomi ./database/duomi.sql这里有个细节建库时把DEFAULT CHARACTER SET utf8mb4写死不要用默认latin1。聊天记录里有大量表情符号只有utf8mb4能存得住。导入SQL报错时进duomi库执行SHOW TABLES;表数量在20张以上算正常。接下来改数据库配置。多数版本把连接参数放在config.php或database.php结构大致是return [ type mysql, hostname 127.0.0.1, database duomi, username root, password your_password_here, hostport 3306, charset utf8mb4, prefix du_, ];参数说明charset必须是utf8mb4不然表情字段写入就变问号prefix是表前缀跟SQL文件里的实际前缀保持一致改错会连管理员账号都查不到。很多人在这一步把du_改成自己的缩写结果所有SQL都找不到表记得连database/duomi.sql里的建表语句一起改。再设置可写目录和伪静态。Nginx 下我常用的最小站点配置是server { listen 80; server_name kefu.example.com; root /var/www/duomi/public; index index.php index.html; location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; } } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }这段配置的作用是本地找不到文件时把所有路径交给index.php。如果解密包后入口文件在根目录而不是public/就把root改成/var/www/duomirewrite里的/index.php保持不变。最后补权限chmod -R 755 runtime upload chown -R www-data:www-data /var/www/duomi到这里访问http://kefu.example.com要么默认跳到安装向导要么直接打开登录页。安装向导里的“环境检测”如果标红pdo_mysql或mbstring用apt install php7.4-mysql php7.4-mbstring或yum install装完重启 PHP-FPM 再看。3. 拆开朵米3.5从路由到客服分配再到消息推送3.1 入口与控制器先定位 index.php 和模块目录很多新手拿到源码后第一直觉是去翻模板文件那是错的。客服系统的核心逻辑不在页面里而在入口文件、路由和控制器之间。这套源码的结构入口在public/index.php路由走的是 pathinfo 风格常见写法是// public/index.phpThinkPHP 风格的常见写法 require __DIR__ . /../vendor/autoload.php; $app new \think\App(); $app-run();这里不复杂第一行拉框架自动加载第二行创建应用实例并启动。如果你拿到的版本没有vendor目录说明压缩包被裁掉了依赖先去补框架依赖再说。入口文件确认后推荐用一条命令定位核心控制器grep -r class Kefu application/ 2/dev/null在application目录里搜Kefu、Msg、Session这几个类名能快速知道模块分布。客服系统的三个核心是客服管理、消息收发、会话分配。看到类名后顺着文件路径就能找到对应方法比从头读模板高效得多。3.2 多客服分配的优先级从一张客服表里选出下一个接待人多客服分配的逻辑听起来玄其实落点很具体查客服表按条件过滤按负载排序取一条记录。最常见规则是“只找在线且空闲的坐席当前接待数越少越优先”。简化后的代码大概是这样// 简化后的分配逻辑在线 空闲 当前接待数最少的坐席 public function assignKefu($visitorId) { $kefu Db::name(kefu) -where(online, 1) -where(busy, 0) -order(queue_count ASC, last_online_time DESC) -find(); if ($kefu) { Db::name(session)-insert([ visitor_id $visitorId, kefu_id $kefu[id], status 1, ]); } return $kefu[id] ?? 0; }参数说明online表示客服是否在线busy表示是否手动置忙queue_count是该客服当前未关闭会话数last_online_time作为并列排序时的时间戳。调整业务规则时改这三个字段即可比如要实现“技能组优先”就在表里加group_id分配前先按group_id过滤。这个地方最容易踩的坑是queue_count没有实时递减。客服关闭一个会话后queue_count还停在旧值导致后续流量全砸给第一个客服。排查方法是看客服后台列表的“当前接待数”是否准确不准确就去会话关闭的控制器里找where(status, , closed)对应的更新语句。3.3 消息推送为什么客服端“总是慢半拍”朵米这种PHP客服系统多数不靠WebSocket而是前端定时拉取。访客发消息写入数据库客服端每隔几秒请求一次轮询接口把“比 last_id 大的新消息”取走。慢半拍的系统通常不是服务器不行而是last_id没有推进到位。简化版接口是这样的public function pollMsg() { $lastId (int) input(last_id); $list Db::name(msg) -where(to_kefu_id, $this-kefuId) -where(id, , $lastId) -where(is_read, 0) -limit(50) -select(); return json([ code 0, data $list, last_id input(last_id), ]); }参数说明last_id是前端传过来的消息自增IDlimit(50)限制单次拉取条数is_read0保证只拿未读消息。这个接口返回后前端要立刻把last_id更新成新消息的最大ID否则下轮轮询还会重复读旧数据。很多“消息丢失”其实是前端把last_id存到了内存刷新页面就归零最后靠查数据库才发现消息都没丢只是重复拉取又被覆盖了。如果想把轮询改成WebSocket不要急着推倒重来。先看源码里有没有message表和msg_status表只要有这两张表WebSocket服务端只需要监听msg表新增记录再把记录推给对应kefu_id即可。消息体结构不变前端换一下传输层就行。3.4 会话状态机会话表里的状态字段不能乱用会话表里通常有一个status字段1是进行中2是已结束3是排队中4是留言状态。这个字段是分配逻辑、统计报表、客服待办列表共用的一条主线。手动改它的后果比想象中严重把排队中的会话改成已结束queue_count递减逻辑可能失效把进行中的会话改成留言客服待办里会凭空少一条。我一般会坚持两条原则第一状态变更统一走控制器方法不在SQL里直接UPDATE第二如果要加“机器人接待中”这种新状态新增status5不要复用已有值。这样报表脚本、分配脚本才能在同一个状态口径下工作。4. 避坑朵米3.5部署后最常见的5个坑现象、原因、解决4.1 页面空白且不报错PHP版本太高是首因现象首页、安装向导直接白屏浏览器控制台什么错误都没有。原因源码里的旧语法在PHP 8.0下被移除了或者运行环境缺少mbstring、pdo_mysql扩展。解决先把PHP版本降到7.4再执行php -m | grep mbstring和php -m | grep pdo_mysql缺哪个装哪个。临时排查阶段把入口文件的错误显示打开方便看到真实报错。4.2 登录后台后内页全部404伪静态没生效现象首页能打开但后台所有菜单都是404。原因Nginx伪静态规则没加载或者root指向的目录不对。解决确认入口是在根目录还是public/把root改成入口文件所在目录重新nginx -t检查配置再nginx -s reload。注意if (!-e $request_filename)这条规则要放在location /下不要漏。4.3 客服端不弹新消息但数据库里已经有记录现象访客发消息坐席端一动不动登录MySQL看却已经写入。原因轮询接口的is_read没被接口更新或者前端last_id始终是旧值每次拉取都拉到重复数据后又被丢弃。解决用浏览器开发者工具直接看轮询接口返回值确认返回的data是否为空再清一次前端缓存。如果接口返回了消息但页面不渲染去检查前端对msg_type的分支处理。4.4 上传的图片和头像显示403接口返回正常现象聊天图片、客服头像链接打开403。原因上传目录权限不对或者Nginx禁止了upload子目录。解决执行chmod -R 755 upload、chown -R www-data:www-data /var/www/duomi然后在Nginx配置里放行该目录不加任何deny规则。4.5 SQL导入到一半中断表结构缺了一半现象导入SQL时第二个表就开始报错后面全是乱码。原因用phpMyAdmin导入超出上传大小限制或SQL文件里utf8与utf8mb4混用。解决放弃页面导入改用命令行mysql -uroot -p duomi ./database/duomi.sql并在导入前确认建库语句里的字符集是utf8mb4。5. 二次开发把朵米3.5改造成符合你业务规则的客服系统5.1 按来源页调整客服接待权重最简单也最常用的改造是“来源页加权”访客从价格页进入时接待优先级要高于普通列表页。这个逻辑只需要在分配客服前加一次来源判断public function assignKefu($visitorId) { $referer input(referer, ); $weight 0; if (strpos($referer, price) ! false) { $weight 20; } $kefu Db::name(kefu) -where(online, 1) -where(busy, 0) -order(queue_count . $weight . ASC, last_online_time DESC) -find(); return $kefu[id] ?? 0; }这里的$weight不是直接让某个客服接单而是让该来源的会话在排序时获得更低的queue_count weight值效果等于把高价值访客排到空闲客服的前面。调整weight时注意不要让负数出现否则会出现“排队数越多反而越优先”的反向效果。5.2 把欢迎语和自动回复变成后台配置原始版本里的欢迎语常常硬编码在模板或控制器里改一次话术就得动代码。改造思路是把话术抽到一张auto_reply表后台可以维护关键词和回复内容$auto Db::name(auto_reply) -where(keyword, like, % . $message . %) -where(status, 1) -order(sort ASC) -find(); if ($auto) { // 命中关键词后作为机器人消息写入 msg 表 Db::name(msg)-insert([ session_id $sessionId, content $auto[content], msg_type 2, ]); }参数说明keyword支持模糊匹配sort字段控制多个关键词命中时先回复谁msg_type2用来标记机器人消息避免和人工回复混在一个统计口径里。这个表一建运营就能自己在后台加活动话术不用每次来找开发改模板。5.3 统计报表用SQL计算平均响应时长客服系统的运营最关心“响应快不快”这个指标在消息表里算即可。前提是表里同时记录了访客消息时间和客服回复时间SELECT kefu_id, COUNT(*) AS reply_cnt, AVG(TIMESTAMPDIFF(SECOND, visitor_time, reply_time)) AS avg_response FROM msg WHERE msg_type 1 AND reply_time IS NOT NULL GROUP BY kefu_id;visitor_time是访客消息发出时间reply_time是该会话下客服第一条回复时间TIMESTAMPDIFF算出两者相差秒数并取平均。注意msg_type1只统计人工消息不然机器人秒回会把平均值拉得特别好看失去参考意义。5.4 二次开发红线尽量不改原表结构追加字段时我会优先建扩展表而不是往原表加列。比如要记录客户等级新建customer_extra表用visitor_id关联。理由很简单一旦改了原表结构后续拿到补丁包升级时SQL合并会让你痛不欲生。扩展表可以等升级完再同步数据结构改动小、影响范围可控。这个习惯帮我避过好几次“升级打补丁结果报字段不存在”的血泪教训。6. 上线前的验证和备份三分钟验证清单与回滚演练上线前别急着把域名切过去先按这个清单过一遍。访客端验证能否正常发起会话、能否发送表情和图片、刷新页面后历史消息是否还在。坐席端验证能否收到新会话提醒、能否关闭会话、转接是否生效。数据端验证msg表里是否有新记录session表状态是否从1切到2报表SQL能否查到今天的回复量。最后是权限验证非管理员登录后台是否会被拦截。备份最小命令也就两行mysqldump -uroot -p --single-transaction duomi duomi_$(date %Y%m%d).sql tar -czf duomi_src_$(date %Y%m%d).tar.gz -C /var/www duomi --exclude runtime--single-transaction可以让备份过程不锁表适合客服系统这种在线业务。回滚演练也要做mysql -uroot -p duomi duomi_20250601.sql tar -xzf duomi_src_20250601.tar.gz -C /var/www我给自己定的规矩是每次上线前必须跑一遍备份恢复恢复完再用后台账号登录一次确认客服列表和会话记录都还在。有一年我大意了只备份数据库没打包模板回滚时页面布局全乱客服点不了按钮老板当众念了我一中午。那之后我的习惯是先打包源码和上传目录再导出数据库最后才动代码。希望帮到你。本文还有配套的精品资源点击获取 朵米3.5客服系统源码部署与二次开发实战指南
简介朵米3.5客服系统源码2023正式版是一套面向企业级客户服务场景的全功能PHP解决方案适合需要搭建在线客服平台的技术人员、中小企业以及二次开发学习者。系统支持在线聊天、邮件、电话等多渠道接入具备智能分流、数据统计与客户行为分析能力能有效提升客服团队响应速度与服务质量。压缩包共2000个文件整体体积43.85MB以JS、HTML、CSS等前端界面资源为主辅以PHP业务逻辑、SQL数据库初始化脚本、Shell部署脚本以及DOCX格式的安装配置文档结构清晰便于快速定位。目前已有384人学习下载资源包含可直接部署的网站程序、数据库文件及《朵米3.5客服系统安装搭建配置文档》文档详细说明了CentOS7.6-7.9、宝塔面板、Nginx1.18-1.22、PHP7.1-7.3、MySQL5.6-5.7等运行环境的搭建步骤。无论是直接上线一套客服系统还是研究ThinkPHP架构下的多客服分流与消息处理机制这份源码都提供了完整的实践参考与二次开发基础。1. 朵米3.5客服系统源码2023正式版它是源码不是开箱即用的成品拿到朵米3.5客服系统源码2023正式版第一反应通常是“装完就能上线”真动手你会发现能打开安装向导只是最轻松的一步接下来要面对的是PHP版本、伪静态、消息推送延迟和客服分配策略这几道门槛。这套源码的本质是一个用PHP写成的在线客服工作台访客端和坐席端通过轮询或长连接交换消息会话内容、客服资料和机器人话术都沉淀在MySQL里。你需要给门户站配在线咨询或者想把老旧的留言板换成实时客服这个版本就能当底座尤其适合想读懂一套客服产品是如何设计的新手。它不会替你把未来需求都想好但它值得拆开看。2. 朵米3.5本地部署确认版本、选定环境和最小启动步骤2.1 解压后先别急着装用这份清单确认“正式版”成色我习惯把源码建站和纯二次开发分开。如果是把朵米3.5当现成网站部署最先确认的不是功能而是完整性。压缩包里如果少一个SQL文件或一段伪静态规则后面会花两倍时间补。所以解压后的第一件事是对着下面这张表逐项打勾。检查项常见位置为什么重要入口文件根目录 index.php 或 public/index.php少了它任何请求都打不进PHP安装SQLinstall/ 或 database/ 下的 .sql少了它连管理员表都没有应用配置application/config.php 或 data/config.php数据库账号、日志级别都靠它伪静态规则.htaccess / nginx.conf少了它后台所有菜单都是404可写目录runtime / tmp / upload少了写权限一登录就报错我在拿到一份压缩包之后最先执行的是这条查找命令两秒钟就能看出有没有SQL和伪静态文件cd /var/www/duomi find . -maxdepth 3 \( -iname *.sql -o -name .htaccess -o -name nginx.conf \) -type f这条命令把三层目录以内的.sql、.htaccess、nginx.conf都列出来。如果返回为空说明这份包被二次压缩过去掉了很多关键文件。再看PHP版本要求cat composer.json 2/dev/null || grep -r php --include*.json . | headcomposer.json里的require.php字段会写清支持范围如果包精简到没有composer.json就去安装向导的“环境检测”页面看版本提示。我见过有人不看这一步拿到包直接扔到PHP 8上面页面白屏两小时才开始排查。2.2 环境怎么选PHP 7.4、MySQL 5.7、Nginx 的兼容性逻辑这套源码是典型的php源码项目跑在 LNMP 上最省心。很多人习惯性装最新版PHP结果在PHP 8上翻车因为老框架里大量写法在8.x已经列为废弃或直接移除。我的固定组合如下组件推荐版本理由PHP7.4兼容性好pdo_mysql、mbstring扩展齐全老代码改动最小MySQL5.7utf8mb4支持稳定报表SQL语法兼容度高Nginx1.24 或 1.26伪静态规则好控制不开Apache也能跑Redis可选如果源码带消息队列模块再启用选择PHP 7.4还有一个原因它处于安全维护期既有社区插件支持又不像8.x那样对旧框架不友好。MySQL别用8.0倒不是不能用而是老SQL文件里如果有ENGINEMyISAM或者字符集混用在8.0下会冒出权限和排序规则的问题问题不大但很烦。2.3 最小启动步骤建库、导数据、改配置先把数据库建出来。如果SQL文件在database/目录下最小步骤如下mysql -uroot -p -e CREATE DATABASE duomi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p duomi ./database/duomi.sql这里有个细节建库时把DEFAULT CHARACTER SET utf8mb4写死不要用默认latin1。聊天记录里有大量表情符号只有utf8mb4能存得住。导入SQL报错时进duomi库执行SHOW TABLES;表数量在20张以上算正常。接下来改数据库配置。多数版本把连接参数放在config.php或database.php结构大致是return [ type mysql, hostname 127.0.0.1, database duomi, username root, password your_password_here, hostport 3306, charset utf8mb4, prefix du_, ];参数说明charset必须是utf8mb4不然表情字段写入就变问号prefix是表前缀跟SQL文件里的实际前缀保持一致改错会连管理员账号都查不到。很多人在这一步把du_改成自己的缩写结果所有SQL都找不到表记得连database/duomi.sql里的建表语句一起改。再设置可写目录和伪静态。Nginx 下我常用的最小站点配置是server { listen 80; server_name kefu.example.com; root /var/www/duomi/public; index index.php index.html; location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; } } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }这段配置的作用是本地找不到文件时把所有路径交给index.php。如果解密包后入口文件在根目录而不是public/就把root改成/var/www/duomirewrite里的/index.php保持不变。最后补权限chmod -R 755 runtime upload chown -R www-data:www-data /var/www/duomi到这里访问http://kefu.example.com要么默认跳到安装向导要么直接打开登录页。安装向导里的“环境检测”如果标红pdo_mysql或mbstring用apt install php7.4-mysql php7.4-mbstring或yum install装完重启 PHP-FPM 再看。3. 拆开朵米3.5从路由到客服分配再到消息推送3.1 入口与控制器先定位 index.php 和模块目录很多新手拿到源码后第一直觉是去翻模板文件那是错的。客服系统的核心逻辑不在页面里而在入口文件、路由和控制器之间。这套源码的结构入口在public/index.php路由走的是 pathinfo 风格常见写法是// public/index.phpThinkPHP 风格的常见写法 require __DIR__ . /../vendor/autoload.php; $app new \think\App(); $app-run();这里不复杂第一行拉框架自动加载第二行创建应用实例并启动。如果你拿到的版本没有vendor目录说明压缩包被裁掉了依赖先去补框架依赖再说。入口文件确认后推荐用一条命令定位核心控制器grep -r class Kefu application/ 2/dev/null在application目录里搜Kefu、Msg、Session这几个类名能快速知道模块分布。客服系统的三个核心是客服管理、消息收发、会话分配。看到类名后顺着文件路径就能找到对应方法比从头读模板高效得多。3.2 多客服分配的优先级从一张客服表里选出下一个接待人多客服分配的逻辑听起来玄其实落点很具体查客服表按条件过滤按负载排序取一条记录。最常见规则是“只找在线且空闲的坐席当前接待数越少越优先”。简化后的代码大概是这样// 简化后的分配逻辑在线 空闲 当前接待数最少的坐席 public function assignKefu($visitorId) { $kefu Db::name(kefu) -where(online, 1) -where(busy, 0) -order(queue_count ASC, last_online_time DESC) -find(); if ($kefu) { Db::name(session)-insert([ visitor_id $visitorId, kefu_id $kefu[id], status 1, ]); } return $kefu[id] ?? 0; }参数说明online表示客服是否在线busy表示是否手动置忙queue_count是该客服当前未关闭会话数last_online_time作为并列排序时的时间戳。调整业务规则时改这三个字段即可比如要实现“技能组优先”就在表里加group_id分配前先按group_id过滤。这个地方最容易踩的坑是queue_count没有实时递减。客服关闭一个会话后queue_count还停在旧值导致后续流量全砸给第一个客服。排查方法是看客服后台列表的“当前接待数”是否准确不准确就去会话关闭的控制器里找where(status, , closed)对应的更新语句。3.3 消息推送为什么客服端“总是慢半拍”朵米这种PHP客服系统多数不靠WebSocket而是前端定时拉取。访客发消息写入数据库客服端每隔几秒请求一次轮询接口把“比 last_id 大的新消息”取走。慢半拍的系统通常不是服务器不行而是last_id没有推进到位。简化版接口是这样的public function pollMsg() { $lastId (int) input(last_id); $list Db::name(msg) -where(to_kefu_id, $this-kefuId) -where(id, , $lastId) -where(is_read, 0) -limit(50) -select(); return json([ code 0, data $list, last_id input(last_id), ]); }参数说明last_id是前端传过来的消息自增IDlimit(50)限制单次拉取条数is_read0保证只拿未读消息。这个接口返回后前端要立刻把last_id更新成新消息的最大ID否则下轮轮询还会重复读旧数据。很多“消息丢失”其实是前端把last_id存到了内存刷新页面就归零最后靠查数据库才发现消息都没丢只是重复拉取又被覆盖了。如果想把轮询改成WebSocket不要急着推倒重来。先看源码里有没有message表和msg_status表只要有这两张表WebSocket服务端只需要监听msg表新增记录再把记录推给对应kefu_id即可。消息体结构不变前端换一下传输层就行。3.4 会话状态机会话表里的状态字段不能乱用会话表里通常有一个status字段1是进行中2是已结束3是排队中4是留言状态。这个字段是分配逻辑、统计报表、客服待办列表共用的一条主线。手动改它的后果比想象中严重把排队中的会话改成已结束queue_count递减逻辑可能失效把进行中的会话改成留言客服待办里会凭空少一条。我一般会坚持两条原则第一状态变更统一走控制器方法不在SQL里直接UPDATE第二如果要加“机器人接待中”这种新状态新增status5不要复用已有值。这样报表脚本、分配脚本才能在同一个状态口径下工作。4. 避坑朵米3.5部署后最常见的5个坑现象、原因、解决4.1 页面空白且不报错PHP版本太高是首因现象首页、安装向导直接白屏浏览器控制台什么错误都没有。原因源码里的旧语法在PHP 8.0下被移除了或者运行环境缺少mbstring、pdo_mysql扩展。解决先把PHP版本降到7.4再执行php -m | grep mbstring和php -m | grep pdo_mysql缺哪个装哪个。临时排查阶段把入口文件的错误显示打开方便看到真实报错。4.2 登录后台后内页全部404伪静态没生效现象首页能打开但后台所有菜单都是404。原因Nginx伪静态规则没加载或者root指向的目录不对。解决确认入口是在根目录还是public/把root改成入口文件所在目录重新nginx -t检查配置再nginx -s reload。注意if (!-e $request_filename)这条规则要放在location /下不要漏。4.3 客服端不弹新消息但数据库里已经有记录现象访客发消息坐席端一动不动登录MySQL看却已经写入。原因轮询接口的is_read没被接口更新或者前端last_id始终是旧值每次拉取都拉到重复数据后又被丢弃。解决用浏览器开发者工具直接看轮询接口返回值确认返回的data是否为空再清一次前端缓存。如果接口返回了消息但页面不渲染去检查前端对msg_type的分支处理。4.4 上传的图片和头像显示403接口返回正常现象聊天图片、客服头像链接打开403。原因上传目录权限不对或者Nginx禁止了upload子目录。解决执行chmod -R 755 upload、chown -R www-data:www-data /var/www/duomi然后在Nginx配置里放行该目录不加任何deny规则。4.5 SQL导入到一半中断表结构缺了一半现象导入SQL时第二个表就开始报错后面全是乱码。原因用phpMyAdmin导入超出上传大小限制或SQL文件里utf8与utf8mb4混用。解决放弃页面导入改用命令行mysql -uroot -p duomi ./database/duomi.sql并在导入前确认建库语句里的字符集是utf8mb4。5. 二次开发把朵米3.5改造成符合你业务规则的客服系统5.1 按来源页调整客服接待权重最简单也最常用的改造是“来源页加权”访客从价格页进入时接待优先级要高于普通列表页。这个逻辑只需要在分配客服前加一次来源判断public function assignKefu($visitorId) { $referer input(referer, ); $weight 0; if (strpos($referer, price) ! false) { $weight 20; } $kefu Db::name(kefu) -where(online, 1) -where(busy, 0) -order(queue_count . $weight . ASC, last_online_time DESC) -find(); return $kefu[id] ?? 0; }这里的$weight不是直接让某个客服接单而是让该来源的会话在排序时获得更低的queue_count weight值效果等于把高价值访客排到空闲客服的前面。调整weight时注意不要让负数出现否则会出现“排队数越多反而越优先”的反向效果。5.2 把欢迎语和自动回复变成后台配置原始版本里的欢迎语常常硬编码在模板或控制器里改一次话术就得动代码。改造思路是把话术抽到一张auto_reply表后台可以维护关键词和回复内容$auto Db::name(auto_reply) -where(keyword, like, % . $message . %) -where(status, 1) -order(sort ASC) -find(); if ($auto) { // 命中关键词后作为机器人消息写入 msg 表 Db::name(msg)-insert([ session_id $sessionId, content $auto[content], msg_type 2, ]); }参数说明keyword支持模糊匹配sort字段控制多个关键词命中时先回复谁msg_type2用来标记机器人消息避免和人工回复混在一个统计口径里。这个表一建运营就能自己在后台加活动话术不用每次来找开发改模板。5.3 统计报表用SQL计算平均响应时长客服系统的运营最关心“响应快不快”这个指标在消息表里算即可。前提是表里同时记录了访客消息时间和客服回复时间SELECT kefu_id, COUNT(*) AS reply_cnt, AVG(TIMESTAMPDIFF(SECOND, visitor_time, reply_time)) AS avg_response FROM msg WHERE msg_type 1 AND reply_time IS NOT NULL GROUP BY kefu_id;visitor_time是访客消息发出时间reply_time是该会话下客服第一条回复时间TIMESTAMPDIFF算出两者相差秒数并取平均。注意msg_type1只统计人工消息不然机器人秒回会把平均值拉得特别好看失去参考意义。5.4 二次开发红线尽量不改原表结构追加字段时我会优先建扩展表而不是往原表加列。比如要记录客户等级新建customer_extra表用visitor_id关联。理由很简单一旦改了原表结构后续拿到补丁包升级时SQL合并会让你痛不欲生。扩展表可以等升级完再同步数据结构改动小、影响范围可控。这个习惯帮我避过好几次“升级打补丁结果报字段不存在”的血泪教训。6. 上线前的验证和备份三分钟验证清单与回滚演练上线前别急着把域名切过去先按这个清单过一遍。访客端验证能否正常发起会话、能否发送表情和图片、刷新页面后历史消息是否还在。坐席端验证能否收到新会话提醒、能否关闭会话、转接是否生效。数据端验证msg表里是否有新记录session表状态是否从1切到2报表SQL能否查到今天的回复量。最后是权限验证非管理员登录后台是否会被拦截。备份最小命令也就两行mysqldump -uroot -p --single-transaction duomi duomi_$(date %Y%m%d).sql tar -czf duomi_src_$(date %Y%m%d).tar.gz -C /var/www duomi --exclude runtime--single-transaction可以让备份过程不锁表适合客服系统这种在线业务。回滚演练也要做mysql -uroot -p duomi duomi_20250601.sql tar -xzf duomi_src_20250601.tar.gz -C /var/www我给自己定的规矩是每次上线前必须跑一遍备份恢复恢复完再用后台账号登录一次确认客服列表和会话记录都还在。有一年我大意了只备份数据库没打包模板回滚时页面布局全乱客服点不了按钮老板当众念了我一中午。那之后我的习惯是先打包源码和上传目录再导出数据库最后才动代码。希望帮到你。本文还有配套的精品资源点击获取