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=newBucketManager($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$bucketbucketName *@returnpersistentId */ publicfunctionpersistentOps($key,$bucket,$pfop,$notifyUrl='',$check=true) { header('Access-Control-Allow-Origin:*'); $auth=$this->getAuth(); $persistOps=newPersistentFop($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,sdkfunctions.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数组了。
publicfunctionpdf2PngPfop($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。
回调地址函数
publicfunctionactionQiniuCallback() { $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来做这个文档转换七牛七牛遇到的一个主要问题就是超时的问题,所以我们可以把转换的过程拆解,在数据库中保存处理状态,然后用定时任务来自动处理。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持毛票票。