pfop.md

资源数据处理

简介

对空间中的资源请求 pfop 持久化数据处理。参考：七牛数据处理 pfop 文档

配置文件选项

操作需指定数据源，请先配置数据源

配置参数

process=pfop 
ak= 
sk= 
bucket=
pipeline=
fops-index=
pfop-config=
force-public=

参数名	参数值及类型	含义
process=pfop	数据处理时设置为pfop	表示数据处理操作
ak、sk	长度40的字符串	七牛账号的ak、sk，通过七牛控制台个人中心获取，当数据源为 qiniu 时无需再设置
bucket	字符串	操作的资源原空间，当数据源为 qiniu 时无需再设置
pipeline	字符串	进行持久化数据处理的队列名称
force-public	true/false	是否强制使用共有队列（会有性能影响）
fops-index	字符串	转码命令索引（下标），pfop 操作时指定，明确指定文件名对应的转码命令，建议命令中携带 saveas 重命名指令否则使用默认名
pfop-config	文件路径字符串	进行转码和另存规则设置的 json 配置文件路径，可设置多个转码条件和指令，该配置会覆盖 fops-index 设置的转码命令，配置写法

关于 fops-index

指定输入行中对应转码的命令字段下标，不设置为则无法进行解析。由于转码必须参数包含 key 和 fops，因此输入行中也必须包含 key 字段的值，使用 indexes 参数设置 key 下标，同时 key 下标不能与 fops 下标相同。

# pfop-config 配置文件内容写法如下：

{
  "pfop":[
    {
      "cmd":"avthumb/mp4/s/1280x720/autoscale/1",
      "saveas":"bucket:$(key)F720.mp4"
    },
    {
      "cmd":"avsmart/mp4",
      "saveas":"bucket:$(key)-avsmart.mp4"
    }
  ]
}

如上所示，pfop 操作的配置名称为 "pfop"，配置项为 json array，可参见 pfop-config 配置

必须选项	含义
key	上述配置文件中的 "F720" 为转码项名称，设置为 json key，key 不可重复，重复情况下后者会覆盖前者
cmd	需要指定的转码指令
saveas	转码结果另存的格式，写法为：":"，其中 支持变量 $(key) 表示这一部分为原文件名

关于 saveas

魔法变量

$(name) 表示完整的原始文件名（如 a.jpg/a.png 的 $(name) 分别为为 a.jpg/a.png）
$(key) 表示去除后缀的原始文件名（如 a.jpg/a.png/a 的 $(key) 均为 a）
$(ext) 表示文件名的后缀部分（如 a.jpg/b.jpg 的 $(ext) 均为 jpg，c 的 $(ext) 为空字符串）

格式拼接

格式需要遵循 :，允许只有 ，此时表示由七牛自动生成文件名，但是不允许缺少 ，且不允许以 : 开头或结尾的格式。

命令行方式

-process=pfop -ak= -sk= -bucket= -pipeline= -force-public=