README

关于

Cloudinary 媒体编辑 PHP SDK 允许您快速轻松地将应用程序与 Cloudinary 集成。轻松编辑和交付云存储的资产。

附加文档

此 Readme 提供了基本的安装和使用信息。有关完整文档，请参阅媒体编辑 SDK 指南。

主要功能

媒体交付 API

媒体编辑 API

TransformApi

版本支持

安装

composer require "cloudinary/media-editing"

使用

设置

<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure with CLOUDINARY_URL
$config = Cloudinary\Configuration::getDefaultConfiguration()
    ->setCloudinaryUrl('cloudinary://key:secret@cloud_name');

创建媒体源

如何添加媒体存储的示例，在这种情况下是一个新的媒体源

$apiInstance = new Cloudinary\MediaDelivery\Api\MediaSourceApi(null, $deliveryConfig);

// Payload to create the Media Source
$mediaSourceCreatePayload = [
    "display_name" => "my_media_source",
    "source_type"  => "s3",
    "config"       => [
        "s3_bucket_name" => "my_bucket",
        "s3_bucket_folder" => "my_bucket_folder",
        "s3_access_key" => "123456789",
        "s3_secret_key" => "123456789",
        "s3_uri_template" => "s3://my_bucket/images/{{vars.signature}}/{{fwd_key}}",
    ],
];

try {
    $result = $apiInstance->createMediaSource($mediaSourceCreatePayload);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling MediaSourceApi->createMediaSource: ', $e->getMessage(), PHP_EOL;
}

转换和存储

如何转换和存储资产的示例

$apiInstance = new TransformAndStoreApi(null, $config);

$mediaSource = new MediaConnectorInstance();
$mediaSource->setId("11fcd4a3b294515067f1266c7e7f0422")->setFwdKey("sample");

$mediaTarget = new MediaConnectorInstance();
$mediaTarget->setId("33832c937c251b8566e4210736cec544")->setFwdKey("new_sample");

$transformRequest = new TransformRequest();

$transformation = new TransformationDescriptor();
$transformation->setCanonicalTransformation("c_scale,w_500");

$transformRequest->setInputType("media_source")
   ->setMediaSource($mediaSource)
   ->setMediaTarget($mediaTarget)
   ->setTransformationDescriptor($transformation);

try {
    $result = $apiInstance->transformAndStore($transformRequest);
    print_r($result);
} catch (\Exception $e) {
    echo 'Exception when calling TransformAndStoreApi->transformAndStore: ', $e->getMessage(), PHP_EOL;
}

缓存预热

如何执行缓存预热的示例

$apiInstance = new Cloudinary\Api\CacheApi(null, $config);

$cacheWarmupRequestPayload = new \Cloudinary\MediaDelivery\Model\CacheWarmupRequestPayload(); // \Cloudinary\MediaDelivery\Model\CacheWarmupRequestPayload | Payload to warm up the cache

$cacheWarmupRequestPayload->setUrl("<your url>");
// $cacheWarmupRequestPayload->setUrl("https://<cloud_name>.media.cloudinary.net/image/upload/c_scale,w_500/sample");

try {
    $result = $apiInstance->warmup($cacheWarmupRequestPayload);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling CacheApi->warmup: ', $e->getMessage(), PHP_EOL;
}

获取帮助

打开 Github 问题（有关 SDK 的问题）
打开支持工单（有关账户的问题）

关于 Cloudinary

Cloudinary 是适用于网站和移动应用的强大媒体 API，Cloudinary 使开发者能够通过多个 CDN 高效地管理、转换、优化和交付图片和视频。最终，观众能够享受响应式和个性化的视觉媒体体验——无论观看设备如何。

附加资源

Cloudinary 转换和 REST API 参考：包括所有 SDK 的语法和示例的综合参考。
MediaJams.dev：由 Cloudinary 开发者编写并由 Cloudinary 开发者阅读的实用案例教程。
DevJams：YouTube 上的 Cloudinary 开发者播客。
Cloudinary 学院：免费的自学课程、导师引导的虚拟课程和现场课程。
代码探索者和功能演示：包含文档中所有代码探索者、Postman 收集和功能演示的一站式商店。
Cloudinary 路线图：您有机会跟踪、投票或建议 Cloudinary 应该开发什么。
Cloudinary Facebook 社区：向其他 Cloudinary 开发者学习和提供帮助。
Cloudinary 账户注册：免费 Cloudinary 账户注册。
Cloudinary 网站

许可

在 MIT 许可下发布。有关详细信息，请参阅 LICENSE 文件。

cloudinary / media-editing

维护者

详细信息