README

Cloudinary API 封装用于 Laravel。

安装

composer require bakerkretzmar/laravel-mapbox

配置

将以下内容添加到您的 .env 文件中

# Required
CLOUDINARY_CLOUD_NAME={your Cloudinary cloud name}
CLOUDINARY_API_KEY={your Cloudinary API key}
CLOUDINARY_API_SECRET={your Cloudinary API secret}

# Optional
CLOUDINARY_BASE_URL={custom base asset URL}
CLOUDINARY_SECURE_URL={secure custom base asset URL}

可选，您可以发布包的配置文件

php artisan vendor:publish --provider="Bakerkretzmar\LaravelCloudinary\LaravelCloudinaryServiceProvider"

使用方法

upload()

Cloudder::upload($filename, $publicId, array $options, array $tags);

with

• $filename：要上传的图像的路径
• $publicId：您希望在 Cloudinary 上使用的 ID，留空则由 Cloudinary 生成随机 ID。
• $options：上传图像的选项，有关更多信息，请查看Cloudinary 文档
• $tags：图像的标签

返回 CloudinaryWrapper。

uploadVideo()

Cloudder::uploadVideo($filename, $publicId, array $options, array $tags);

with

• $filename：要上传的视频的路径
• $publicId：您希望在 Cloudinary 上使用的视频 ID，留空则由 Cloudinary 生成随机 ID。
• $options：上传视频的选项，请查看 Cloudinary 文档以获取更多信息
• $tags：图像的标签

返回 CloudinaryWrapper。

getPublicId()

Cloudder::getPublicId()

返回最后上传资源的 public id。

getResult()

Cloudder::getResult()

返回最后上传资源的结果。

show() + secureShow()

Cloudder::show($publicId, array $options)
Cloudder::secureShow($publicId, array $options)

with

• $publicId：要显示的资源 public id
• $options：上传资源的选项，有关更多信息，请查看 Cloudinary 文档

返回 Cloudinary 上图片的 url（如果使用 secureShow，则为 https url）。

showPrivateUrl()

Cloudder::showPrivateUrl($publicId, $format, array $options)

with

• $publicId：要显示的资源 public id
• $format：要显示的资源格式（'png', 'jpg'...）
• $options：上传资源的选项，有关更多信息，请查看 Cloudinary 文档

返回 Cloudinary 上图片的 private url，默认情况下在 1 小时后过期。

rename()

Cloudder::rename($publicId, $toPublicId, array $options)

with

• $publicId：要重命名资源的 publicId
• $toPublicId：资源的新 publicId
• $options：上传资源的选项，有关更多信息，请查看 cloudinary 文档

使用 $toPublicId ID 参数重命名原始图片。

destroyImage() + delete()

Cloudder::destroyImage($publicId, array $options)
Cloudder::delete($publicId, array $options)

with

• $publicId：要移除资源的 publicId
• $options：要删除的图像的选项，请查看 cloudinary 文档以获取更多信息

从 Cloudinary 中移除图像。

destroyImages()

Cloudder::destroyImages(array $publicIds, array $options)

with

• $publicIds：标识要删除的图片的 ID 数组
• $options：要删除的图像的选项，请查看 cloudinary 文档以获取更多信息

从 Cloudinary 中删除图片。

addTag()

Cloudder::addTag($tag, $publicIds, array $options)

with

• $tag：要应用的标签
• $publicIds：要应用标签的图像
• $options：上传资源的选项，有关更多信息，请查看 cloudinary 文档

removeTag()

Cloudder::removeTag($tag, $publicIds, array $options)

with

• $tag：要删除的标签
• $publicIds：要从中删除标签的图像
• $options：上传图像的选项，有关更多信息，请查看 Cloudinary 文档

createArchive()

Cloudder::createArchive(array $options, $archiveName, $mode)

with

• $options：归档的选项，如名称，选择图像的 tag/前缀/public ids
• $archiveName：您想要给归档的名称
• $mode：'create' 或 'download' ('create' 将创建归档并返回包含归档属性的 JSON 响应，'download' 将返回下载的 zip 文件)

在 Cloudinary 上创建 zip 文件。

downloadArchiveUrl()

Cloudder::downloadArchiveUrl(array $options, $archiveName)

with

• $options：归档的选项，如名称，选择图像的 tag/前缀/public ids
• $archiveName：您想要给归档的名称

返回 Cloudinary 上新创建归档的 download url。

运行测试

PHPUnit

示例

您可以在以下仓库中找到一个可工作的示例：cloudder-l5-example

致谢

基于Jeremy Dagorn的cloudder。