七牛php-sdk使用-文档处理

所用到的七牛文档转换服务，主要是：ppt文件转为pdf文件，pdf文件转图片(png)。

描述一下需求：上传PPT或者PDF文件到七牛，最终转换为图片。文件上传部分的功能已经讲过了，这里说一下转换处理的部分。

文档类型

因为七牛整个的文件存储系统中文件类型并不靠后缀来区分，而是有它自己的文件类型(mineType)，所以在堆bucket中的资源进行处理的时候，首先要判断minetype。

多次的测试结果表明，pdf文件上传后的minetype一为application/pdf，而ppt上传后的类型就比较多了，通过jssdk上传，以及直接在七牛上传，上传后缀为ppt、pptx的结果都有可能不一样。最终总结出如下的几种类型：

application/vnd.openxmlformats-officedocument.presentationml.presentation
application/zip
application/vnd.ms-powerpoint
application/ppt
application/x-ole-storage

这里的文档类型判断PHP-SDK已经提供了，是BucketManager这个类。

//使用方式

$bucketManager = new BucketManager($this->getAuth());//getAuth()方法见七牛php-sdk使用-文件上传

$mineTypeInfo  = $bucketManager->stat(bucketName, 七牛资源名);

$mimeType      = $mineTypeInfo[0]['mimeType'];

持久化处理

七牛的服务都是通过http请求附加不同的参数来实现的，比如我们处理剪裁一张图片，或者获取视频某一秒的截图，在我们的页面中可以直接使用src=http://qiniu.com.cn?xxx这种方式，就能得到我们想要结果，但有的时候我们需要把处理的结果保存到我们的bucket中，这个就是持久化处理了。

根据sdk封装一个持久化处理的方法，用到的sdk类为PersistentFop：

/**

 * 文件持久化处理

 * @param   $key 七牛资源名

 * @param   $pfop 对资源进行的数据处理操作的命令

 * @param   $bucket bucketName

 * @return  persistentId

 */

 public function persistentOps($key,$bucket,$pfop,$notifyUrl='',$check=true)

 {

     header('Access-Control-Allow-Origin:*');

     $auth = $this->getAuth();

     $persistOps = new PersistentFop($auth,$bucket,$this->qiniu_image_pipeline,$notifyUrl);

     list($id,$error) = $persistOps->execute($key,$pfop);

     if($check){

	     //可暂时忽略，用来检查资源持久化处理状态

         $result = $this->checkStatus($id,$persistOps);

     }else{

         $result = true;

     }

     return $result;

 }

PPT转PDF

使用到的持久化出来命令为:$pfop[] = 'yifangyun_preview/v2|saveas/'.$key;，这里使用的是七牛的第三方文档转换服务，因为七牛之前的odconv/pdf已经不再更新维护了，而且出现过转为pdf排版出现遮挡以及乱码等问题，所以改为使用亿方云的服务。

这里面saveas，即保存为一个新的资源，$key需要做一下说明，按照七牛的要求必须是：

$key = \Qiniu\base64_urlSafeEncode(bucketName.':'.$sourceName);

如果不按照规则进行encode，无法保存成功。base64_urlSafeEncode，sdk functions.php中已经存在。

有了原始的key,saveas的key,以及pfop持久化处理命令，就可以调用persistentOps方法了：

$result = $this->persistentOps($sourceName,$bucketName,$pfop);

pfop可以是一个数组，包含多个处理命令。

PDF转图片PNG

因为没有PPT转图片这条路，所以只能先转PDF。

用到的pfop命令：

odconv/png/page/页码/density/150/quality/80|saveas/'.$key;

参数包括页码，质量，像素密度等，还有更多的参数可以查阅文档。所以这里我们首先要获取PDF文档的总页数。使用到的接口命令是：

//odconv/png/info

$url = 'http://'.$this->qiniu_image_domain.'/'.$sourceName.'.pdf?odconv/png/info';

//url部分就是七牛资源可以访问的完整链接，?后面就是要用到的命令

使用curl去请求这个链接，会返回json数据，里面会包含page_num成员。

有了page_num，就可以构造pfop数组了。

public function pdf2PngPfop($page,$sourceName)

{

	 $pfop = [];

     $pngName = $sourceName;//原图

     for($i=1;$i<=$page;$i++){

         $randName = $pngName.'_'.$i.'.png';//原图

         $key = \Qiniu\base64_urlSafeEncode($this->bucket_for_image.':'.$randName);

         $pfop[] = 'odconv/png/page/'.$i.'/density/150/quality/80|saveas/'.$key;

     }

     return $pfop;

 }

然后调用：

$res = $this->persistentOps($sourceName.'.pdf',$this->bucket_for_image,$pfop,'',false);

note：在处理比较大的文档，例如一个PPT有100多页，那PHP运行等待七牛的结果返回再进行数据的保存就可能会超时，一个解决方案，是指定回调url,persistentOps的倒数第二个参数就是回调url，当文档转换完成的时候，七牛会向这个地址发起一个请求，后续的图片链接保存操作我们交给回调来做。

tips: 如果对每个pfop命令都指定回调地址，对我们的（普通）业务服务器也会造成些许的请求压力，所以我的做法是给最后一页的PDF转图片命令添加回调url。

回调地址函数

public function actionQiniuCallback()

{

    $notifyBody = file_get_contents('php://input');

    $notifyBodyArray = json_decode($notifyBody,true);

    $topicId = Yii::$app->request->get('topicId');

    $totalPage = Yii::$app->request->get('totalPage');//pdf页数

	$key = $notifyBodyArray['inputKey'];//这个是pdf文件的key

    //业务代码

    ...

}

总结

php来做这个文档转换七牛七牛遇到的一个主要问题就是超时的问题，所以我们可以把转换的过程拆解，在数据库中保存处理状态，然后用定时任务来自动处理。