实战应用WPS WebOffice开放平台服务

概述

根据公司的业务需要，主要功能是在线编辑文档，前端的小伙伴进行的技术调研，接入的是WPS WebOffice，这里只阐述技术介入的步骤、流程和遇到的坑进行的一些总结。

实践

WPS WebOffice 开放平台进行认证

在开始之前，需要在WPS WebOffice 开放平台进行注册和认证，添加应用，申请成功后如下图所示：

在这里插入图片描述

开发和接入

在开始编写代码之前，有三个关键概念要提前了解 webClient（前端客户端）、 WpsServers（Wps服务）、CrmServers(服务端)，请求流程: 前端客户端请求Wps服务，Wps服务请求服务端，进行通知、回调操作。

具体实现，图中左侧是我们具体业务逻辑，右侧是Wps服务请求我们的服务端：

在这里插入图片描述

1.配置路由:WPS WebOffice

开放平台url都是官方定义好的，用路径拼接好的，服务端需要定义一个全局${file_id}来进行通信,强烈推荐在服务端配置自定义路由，这样的实现简单便捷，也可以在Nginx使用重定向进行解决,参数通过截取Url得到。

/** wps 在线文档自定义路由 */
$route['v3/3rd/files/(:any)'] = 'wps/test/files/$1/$2/$3';
$route['v3/3rd/users'] = 'wps/test/users';
$route['v3/3rd/notify'] = 'wps/test/notify';

2.预览

在前端预览的时候，Wps服务文件信息、文件权限、文件下载地址、用户信息4个接口，返回格式要和文档上的一致，不然会产生权限不足的错误，查找起来也是很困难，在这里也说一下接口说明：

120.92.55.139 - - [24/Oct/2024:07:23:57 +0800] "GET /v3/3rd/users?user_ids=45 HTTP/1.1" 200 89 "-" "Go-http-client/1.1"
120.92.55.139 - - [24/Oct/2024:07:23:57 +0800] "GET /v3/3rd/files/HT4319/permission HTTP/1.1" 200 131 "-" "Go-http-client/1.1"
120.92.55.139 - - [24/Oct/2024:07:24:08 +0800] "GET /v3/3rd/files/HT4319 HTTP/1.1" 200 177 "-" "Go-http-client/1.1"
120.92.55.139 - - [24/Oct/2024:07:24:08 +0800] "GET /v3/3rd/files/HT4319/download HTTP/1.1" 200 137 "-" "Go-http-client/1.1"

/v3/3rd/users ：获取用户信息接口，用于在线文件操作中的显示和记录。
/v3/3rd/files/HT4319/permission : 获取当前文件可以操作的权限
/v3/3rd/files/HT4319 ：获取文件的基本信息、创建文件用户、大小等等
/v3/3rd/files/HT4319/download：最容易出错的是这个接口，这个接口中要返回的是文档可以下载的url路径，Wps服务要来这里获取文件数据流。

3.保存

在操作的过程中，每保存一次文件，他就会请求URL一次，我们使用的这个版本用的是三阶段提交，具体阐述如下：

120.92.55.139 - - [24/Oct/2024:07:37:56 +0800] "GET /v3/3rd/files/HT4319/upload/prepare HTTP/1.1" 200 86 "-" "Go-http-client/1.1"
120.92.55.139 - - [24/Oct/2024:07:37:56 +0800] "POST /v3/3rd/files/HT4319/upload/address HTTP/1.1" 200 186 "-" "Go-http-client/1.1"
120.92.55.139 - - [24/Oct/2024:07:37:56 +0800] "GET /v3/3rd/files/HT4319/permission HTTP/1.1" 200 131 "-" "Go-http-client/1.1"
120.92.55.139 - - [24/Oct/2024:07:37:56 +0800] "POST /v3/3rd/files/HT4319/upload/complete HTTP/1.1" 200 179 "-" "Go-http-client/1.1"

/v3/3rd/files/HT4319/upload/prepare : 这个接口的作用是Wps服务与本地服务端协商摘要算法,有 md5 sha1 sha256三个选项，多接口的交互需要保持一致。
/v3/3rd/files/HT4319/upload/address : 这个接口的作用是在编辑的过程中，告诉Wps服务保存文件的Api，Wps服务以文件流的形式来进行请求
/v3/3rd/files/HT4319/upload/complete：Wps服务保存完成后，回调这个接口

以我的/v3/3rd/files/HT4319/upload/address接口为例,返回的完整Json结构,作用是在文件在线编辑的过程中去同步请求url的指定接口。

{"code": 0,"data": {"method": "PUT","url": "https://www.stark.com/api/laborcontract_wps/save_wps","params": {"file_id": "HT4308","name": ""}},"message": ""
}

有两个注意的点，开发过程中，最大的难点就在这里了。
1、save_wps接收的参数是通过upload/address params 传递的，我的$this->posts是参数数组
2、接收到的文件流，重写到指定地址，覆盖之前的文件地址 $savePath

public function save_wps()
{#接收参数$file_id = isset($this->posts['file_id']) ? $this->posts['file_id'] : '';//接收文件流，覆盖文件$stream = file_get_contents('php://input');file_put_contents($savePath, $con);
}