whisper
是一个在线客服系统源码,采用thinkphp5
+Gatewayworker
编写,性能强悍。自己搭建,控制在自己,也无需为您的数据安全担心,您可以应用在任何的正规的网站,只需要添加一段简单的js
代码,就可以使您的网站拥有在线客服功能。
官方网站:http://whisper.baiyf.com/
环境要求:PHP >= 5.6
1、安装宝塔
#Centos系统
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install.sh && sh install.sh
#Ubuntu系统
wget -O install.sh http://download.bt.cn/install/install-ubuntu.sh && sudo bash install.sh
#Debian系统
wget -O install.sh http://download.bt.cn/install/install-ubuntu.sh && bash install.sh
安装完成后,进入面板,点击左侧软件管理,然后安装PHP
、Mysql
、Nginx
、phpmyadmin
。
2、拉取源码
点击左侧网站,添加站点,使用命令:
cd www/wwwroot/xx.com
git clone https://gitee.com/nickbai/whisper_tp5.git
#如果移动的时候有mv提示,直接Enter即可
mv whisper_tp5/{,.}* ./
chmod 775 ./* ./runtime/temp/*
3、网站设置
进入到域名设置,点击网站目录,去除跨站攻击的√
,并设置运行目录为public
。
然后点击伪静态设置,填入以下代码:
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=/$1 last;
break;
}
}
4、新建数据库
点击面板左侧数据库,点击phpmyadmin
进入数据库管理界面,新建whisper
数据库。再将根目录的whisper.sql
文件导入到数据库,然后修改根目录application/database.php
配置信息。
#修改如下
// 服务器地址
'hostname' => '127.0.0.1',
// 数据库名
'database' => 'whisper',
// 用户名
'username' => 'root',
// 密码
'password' => 'root',
// 端口
'hostport' => '3306',
5、安装拓展
环境一般只要安装两个扩展即可,一个是pcntl
,一个是libevent
(event
)。pcntl
为必须的,libevent
为非必须的,但是起到高性能作用的恰恰是libevent
(event
)。如果你您的并发并不是很高,咨询量也不是很大,您可以不安装这个扩展,Gatewayworker
会采用系统的select
同样性能可观。
查看已安装的PHP
拓展:
php -m
这时候发现必需的pcntl
拓展已被安装,接下来就安装另外一个拓展了(一般情况下可以不用安装),即PHP5.x
安装libevent
扩展,PHP7.x
安装event
拓展。
PHP7.x
安装event
拓展,博主以PHP7.0
测试环境,如果你是7.1
将下面目录70
改成71
即可:
#event包下载地址http://pecl.php.net/package/event,这里以最新版2.4.1为准
cd /www/server/php
wget http://pecl.php.net/get/event-2.4.1.tgz
tar -zxvf event-2.4.1.tgz && cd event-2.4.1
/www/server/php/70/bin/phpize
./configure --with-php-config=/www/server/php/70/bin/php-config --with-event-libevent-dir=/www/server/php/event-2.4.1/
make && make install
echo "extension=event.so" >> /www/server/php/70/etc/php.ini
PHP5.x
安装libevent
扩展,这里以PHP5.6
测试环境,使用命令:
cd /www/server/php
wget https://github.com/libevent/libevent/releases/download/release-2.1.8-stable/libevent-2.1.8-stable.tar.gz
tar -zxvf libevent-2.1.8-stable.tar.gz && cd libevent-2.1.8-stable
/www/server/php/56/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config --with-libevent=/www/server/php/libevent-2.1.8-stable/
make && make install
echo "extension=libevent.so" >> /www/server/php/56/etc/php.ini
其实要求不高的,这步可以省略。
6、启动程序
这时候需要先下载服务端文件,下载地址:whisper_server.zip,然后解压上传到网站根目录vendor
目录里,再编辑以下文件。
#编辑vendor/GatewayWorker/Applications/whisper/Events.php文件
#修改数据库名和密码
self::$db = new \Workerman\MySQL\Connection('127.0.0.1', '3306', 'root', 'pass', 'whisper');
然后启动程序:
#进入服务端文件夹
cd /www/wwwroot/xx.com/vendor/GatewayWorker
#后台运行
php start.php start -d
然后再到宝塔的安全里开启8282
端口。
然后再配置application/config.php
,进行如下修改:
'socket' => '192.168.1.104:8282',
ip
填写你服务器的ip
。
搭建成功后程序系统为xx.com
,后台后xx.com/admin
,管理员用户名密码均为admin
,客服的工作台xx.com/service
。
接下来我们进入程序系统首页,点击右下角的客服按钮,如果出现以下提示,则为安装成功,不然请检查你的步骤。
最后我们就将在线客服集成到自己网站。
1、首先在您的网站上引入两段js
对应的地方,换成你刚才部署whisper
事时采用的域名。其实你也可以放本地,只要这个资源能访问到即可。
2、配置参数
var ws = new whisper();
$(dom).click(function(){
var group = $(this).attr('data-group');
ws.init({
id: uid,
url: 'http://xxx.xxx.com/index/index/chat',
name: uname,
avatar: uavatar,
group: group
});
});
3、参数解释
1)dom
是什么?
这里的dom
就是您的客服咨询悬浮框,以whisper
官网的为例子:
即这两部分的dom
的id
,#cs-pre-sales
和#cs-after-sales
:
售前客服
售后客服
其实就是这两个地方的点击事件,此处在这个dom
的地方,放置一个data-group
来设置 这些客服分组的信息。这个id
需要与管理端设置的 异一一对应,否则该分组的客服无法正常的工作。例如whisper
站点上,这个点击事件这么配置的:
$("#cs-pre-sales,#cs-after-sales").click(function(){
// 其他业务代码
})
2)init
中的参数是什么意思?
{
id: uid,
name: uname,
avatar: uavatar,
whisper_domain: 'http://xxx.xxx.com',
group: group
}
对应的信息为:
id 当前登录户用户的唯一id
name 当前登录用户的昵称
avatar 当前登录用户的头像
whisper_domain 您搭建whisper系统的域名
group 用户咨询的客服分组
好了,到此为止,您的whisper
系统算是搭建 和整合完毕了。你可以为你的访客提供咨询服务了。
该程序免费版本只更新到了v1.0.1
,对于大部分网站来说,免费版功能已经够用了。如果想拿来进行商用,需要机器人等功能的话,就要联系作者购买授权了。