# service

**Repository Path**: monjra/service

## Basic Information

- **Project Name**: service
- **Description**: 公众号客服系统
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-12-08
- **Last Updated**: 2025-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## laykefu
thinkphp5+Gatewayworker搭建的web客服系统

客服地址:你的域名/service
账户密码：
客服小美 123456 

后台管理地址:你的域名/admin
账户密码：admin 123456

## 1.客户端接入

1、添加laykefu.css样式文件
```php
    <link href="你的域名/static/customer/css/laykefu.css" rel="stylesheet" type="text/css" />
```

2、添加jquery.js和laykefu.js 文件 
```php  
<script src="https://cdn.staticfile.org/jquery/2.1.4/jquery.min.js"></script>
<script src="你的域名/static/customer/js/laykefu.js"></script>
```

3、添加html目标代码 ，样式可根据需求自定义
```php
<div class="laykefu-min">咨询客服</div>
```
4、初始化laykefu
```php
	laykefu.init({
		socket: '',//聊天服务器地址 本地测试可以设置为127.0.0.1：7272
		face_path:'/static/customer/images/face',//表情包路径
		upload_url:'/index/upload/uploadImg',//图片上传路径
	});

```

```
[可选] nginx反向代理 wss
```
location /wss {
            proxy_pass http://127.0.0.1:7272;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            rewrite /wss/(.*) /$1 break;
            proxy_redirect off;
}
```

[可选] nginx反向代理 ws
```
location /ws {
            proxy_pass http://127.0.0.1:7272;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            rewrite /ws/(.*) /$1 break;
            proxy_redirect off;
}
```

6、可选参数
可配置参数如下
```php
	laykefu.init({
		uid: '',//客户id
		name: '',//客户昵称
		avatar: '',//客户头像
		socket: '',//聊天服务器地址
		face_path:'',//表情包路径
		upload_url:'',//图片上传路径
		height:'',//窗口高度
		width:'',//窗口宽度
	});

``` 
5、关联已有账户系统
默认情况下咨询的客户是随机分配账户信息，如果你的平台有账户系统，那么可以在初始化的时候传递uid和name即可

## 2.服务端配置

去掉php pcntl相关函数禁用(pcntl_alarm,pcntl_fork,pcntl_signal)
根目录指向public
开启伪静态

1、修改application/database.php数据库信息,配置后台socket地址，一般情况下和前台地址相同：

2、如果你是在服务器上运行该项目，请开放7272端口供laykefu使用，以阿里云为例，在`网络和安全`的`安全组`里面`修改规则`，增加7272端口

3、如果指定某个域名才能connect，那么请修改Events.php的HTTP_ORIGIN参数

4、启动gatawayworker相关服务

```php
php serve start -d
```
开启服务
命令如下

启动
以debug（调试）方式启动
php serve start

以daemon（守护进程）方式启动
php serve start -d

停止
php serve stop

重启
php serve restart

平滑重启
php serve reload

查看状态
php serve status

查看连接状态
php serve connections

# 3.客户端地址

## 根路由即是客户端,只能在微信内打开,新用户使用微信授权的信息注册
	你的域名/index/index/index
# 4.客服端地址
### 客服端分为web端及微信端
	web: 你的域名/servie
	wechat: 你的域名/service/index/mobile

* web端需要使用账号密码登录，记录cookie
* wechat端在授权微信后，会使用openid去查询是否已绑定客服,是的话就会跳转到客服端

# 主要技术栈

### 项目构成
    后端使用ThinkPHP框架
    通信服务使用 workman 启动, 支持分布式部署, 内置数据库连接池及分布式缓存

    前端的UI库来自Layui, 由ThinkPHP的模板引擎加上LayUi前端框架构建
    客户端聊天界面使用 LayIM Mobile 构建

### 主要功能

    一个多人售后团队客服系统
    在管理后台可以创建多种角色及账号
    接入了公众号系统, 可通过后台推送消息
    可在后台将创建的角色与微信公众号用户进行绑定
    绑定后的售后人员可以在微信公众号内进入聊天
    团队可由多个终端接入聊天
    用户在微信公众号联系客服
    支持通过公众号推送提醒售后人员或客户新消息接入