币游国际平台

PHP迁移指南

最新更新日期:Dec-18-2023

导 言

上头云式PHPSDK最新主版设计提供简单化和增强开发者经验本指南将解释如何移位原创PHPSDK版本, 包括您需要修改代码和任何其他考量

hpSDK最新版本密钥改进

  • 新建基于动作语法设计,使建楼交付URL和变换更加逻辑化和可发现性
    • 编译归定交付URL时,每个动作(包括任何动作)修饰词表示不同的构件(除以 '/'),例如:/c_scale,w_400/f_auto/q_auto/,而不是/c_scale,f_auto,q_auto,w_400/.
  • 新建自填列表选项和参数并仅确保支持选项和参数可并用

迁移到最新SDK前要知道的事情

最新版本SDK使用基于动作语法可能导致URL组成不同于遗留版本SDK生成

例举 :

  • URL生成遗留SDK
    https://res.www.agrosoland.com/demo/image/upload/c_scale,f_auto,q_auto,w_400/sample.jpg
  • URL生成最新SDK
    https://res.www.agrosoland.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提供从Paramshelper法将原创变换老语法参数允许包扎现有变换语法并维护生成变换URL结构

注意
有大数资产时推荐使用 从Params方法论使用新SDK变换语法替换现有变换时,可发现URL生成方式稍有不同看吧 迁移到最新SDK前要知道的事情,这些修改对变换URL的影响

需要更新实例

  • 云化_url
  • Cl_image_tag
  • CL_View_tag

云化URL

云端URL从遗留版SDK迁移到最新版PHPSDK时,你需要替换云化_urlhelper方法带新媒体实例使用从Params帮助者方法

例举 :

归结式 :

云式图像和视频标签

图像视频标签替换Cl_image_tagCL_View_tag图像塔格视频塔格并包含从Params帮助者方法

例举 :

归结式 :

附加类型

图像从视频投送或反向投送时,需要识别投送类型并使用正确投送方法

举个例子 从视频中提供缩略图 SDK遗留版Cl_image_tag并设置资源类型to视频

最新版云端PHPSDK需要交付正确媒体类型在此示例中,您会使用VideoThumbnailTag:

相关题目

反馈发送

评分本页 :