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

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

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

文档类型

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

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

1. application/vnd.openxmlformats-officedocument.presentationml.presentation
2. application/zip
3. application/vnd.ms-powerpoint
4. application/ppt
5. 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 = Qiniuase64_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 = Qiniuase64_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来做这个文档转换七牛七牛遇到的一个主要问题就是超时的问题，所以我们可以把转换的过程拆解，在数据库中保存处理状态，然后用定时任务来自动处理。