最新更新日期:Dec-18-2023
导 言
上头云式PHPSDK最新主版设计提供简单化和增强开发者经验本指南将解释如何移位原创PHPSDK版本, 包括您需要修改代码和任何其他考量
hpSDK最新版本密钥改进
- 新建基于动作语法设计,使建楼交付URL和变换更加逻辑化和可发现性
- 编译归定交付URL时,每个动作(包括任何动作)修饰词表示不同的构件(除以 '/'),例如:
/c_scale,w_400/f_auto/q_auto/
,而不是/c_scale,f_auto,q_auto,w_400/
.
- 编译归定交付URL时,每个动作(包括任何动作)修饰词表示不同的构件(除以 '/'),例如:
- 新建自填列表选项和参数并仅确保支持选项和参数可并用
最新版本SDK使用基于动作语法可能导致URL组成不同于遗留版本SDK生成
例举 :
- URL生成遗留SDK
https://res.www.aaaalireno.com/demo/image/upload/c_scale,f_auto,q_auto,w_400/sample.jpg
- URL生成最新SDK
https://res.www.aaaalireno.com/demo/image/upload/c_scale,w_400/f_auto/q_auto/sample.jpg
即使是交付媒体文件外观和行为完全相同,对 URLs的修改也可能产生下列影响:
- 可见一次性增量变换计数
- 可见新衍生资产存储用量一次性增加
- URL使用加载变换参数时,你可以看到一次性加载使用量增加
- CDN缓存可能需要用新衍生资产热
- if严格变换允许您的产品环境(控制台安全页设置中),你需要允许新变换
- 需要变换生成热切举长视频例子,你需要通过最新的SDK重生这些视频
热切
参数解析显式方法论
减少所有上述作用,我们建议使用从Params方法变换URLs, 特别是如果应用提供大数变换资产保持变换结构, URLs保持原样 。
所有新变换URL添加应用时, 我们建议使用SDK最新版本提供的新基于动作语法
hpsdk最新版全文档见PHPSDK指南.
预设条件
安装SDK前确保从应用中去除现有的遗留SDK依赖
安装
SDK安装方式与原版相同,说明新版拟安装
例举 :
也可以手动安装从包下载包GitHub存储器并包括进您的项目
迁移
从遗留版迁移到最新版CloudinaryPHPSDK时,你需要更新代码以保留现有功能并允许你利用新功能最新版与老版的主要差异在于媒体交付方式最新版本为构建交付URL提供新语法设计,使之简单逻辑化可能还需要更新设置全局配置方式访问上传管理方法方式小小改变,这需要小重构
配置
if you must设置使用配置CLOUDIORY_URL
环境变量,你将不对需要改变这一点设置全局配置时,需要更新此程序与最新版云端PHPSDK兼容
可使用实例设置配置配置
类 :
或,如果需要多重实例,可使用云化
对象,例如:
上传
最新版云式PHPSDK上传法不再是静态法上传资产到云形系统需要使用上传api
类中
更新所有实例上传
方法使用方法上传api
类比云上传者
上传图像 My_image
归结式 :
详解文档PHPSDK指南.
管理员
相似上传管理方法管理员Api
类中
例举使用资产类
方法类贝斯特登录入口官网下载
遗留版中 :
归结式 :
详解文档PHPSDK指南.
交付
最新版Cloudinary PHPSDK使用新语法创建Cloudinaly URLsm媒体标签,以便完全更新代码,你需要用正确的新语法替换老语法最新SDK提供从Params
helper法将原创变换老语法参数允许包扎现有变换语法并维护生成变换URL结构
需要更新实例
云化_url
Cl_image_tag
CL_View_tag
云化URL
云端URL从遗留版SDK迁移到最新版PHPSDK时,你需要替换云化_url
helper方法带新媒体
实例使用从Params
帮助者方法
例举 :
归结式 :
云式图像和视频标签
图像视频标签替换Cl_image_tag
并CL_View_tag
带图像塔格
并视频塔格
并包含从Params
帮助者方法
例举 :
归结式 :
附加类型
图像从视频投送或反向投送时,需要识别投送类型并使用正确投送方法
举个例子 从视频中提供缩略图 SDK遗留版Cl_image_tag
并设置资源类型
to视频
最新版云端PHPSDK需要交付正确媒体类型在此示例中,您会使用VideoThumbnailTag
: