Provides access to Cloudflare Images API for Laravel projects
To get the latest version of Laravel CloudflareImages, simply require the project using Composer:
$ composer require dedmytro/laravel-cloudflare-imagesOr manually update require block of composer.json and run composer update.
{
"require": {
"dedmytro/laravel-cloudflare-images": "^0.1"
}
}Add environment variables to your .env file:
CLOUDFLARE_IMAGES_ACCOUNT='your-account-id'
CLOUDFLARE_IMAGES_KEY='your-api-key'
CLOUDFLARE_IMAGES_DELIVERY_URL='https://imagedelivery.net/ZWd9g1K8vvvVv_Yyyy_XXX'
CLOUDFLARE_IMAGES_DEFAULT_VARIATION='your-default-variation'or publish config and set up vars there
return [
'account'=> env('CLOUDFLARE_IMAGES_ACCOUNT'),
'key'=> env('CLOUDFLARE_IMAGES_KEY'),
'delivery_url' => env('CLOUDFLARE_IMAGES_DELIVERY_URL'),
'default_variation' => env('CLOUDFLARE_IMAGES_DEFAULT_VARIATION')
];The Direct upload is feature of Cloudflare Images to upload image directly from frontend but without sharing your api key. Once you get this url you can use inside your html
<form method="post" enctype="multipart/form-data" action="{{ $uploadUrl }}">
IMPORTANT: You can use this url only once!
use DeDmytro\CloudflareImages\Facades\CloudflareApi;
$response = CloudflareApi::images()->directUploadUrl()
$response->result->id; // Your uploaded image ID
$response->result->uploadURL; // One-time uploadUrlCall upload() method and pass file as local file path or UploadedFile instance. As a result of upload you'll get DetailsResponse instance with uploaded
image details, so you can save it locally.
use DeDmytro\CloudflareImages\Facades\CloudflareApi;
use DeDmytro\CloudflareImages\Http\Responses\DetailsResponse;
use DeDmytro\CloudflareImages\Http\Entities\Image;
/* @var $file \Illuminate\Http\UploadedFile|string */
/* @var $response DetailsResponse*/
$response = CloudflareApi::images()->upload($file)
/* @var $image Image*/
$image = $response->result
$image->id;
$image->filename;
$image->variants->thumbnail; //Depends on your Cloudflare Images Variants setting
$image->variants->original; //Depends on your Cloudflare Images Variants setting
To list existing images you should use list() method which also has pagination and accept $page and $perPage arguments.
use DeDmytro\CloudflareImages\Facades\CloudflareApi;
/* @var $response ListResponse*/
$response = CloudflareApi::images()->list()
//OR
$response = CloudflareApi::images()->list($page, $perPage)
foreach($response->result as $image){
$image->id;
$image->filename;
$image->variants->thumbnail; //Depends on your Cloudflare Images Variants setting
$image->variants->original; //Depends on your Cloudflare Images Variants setting
}To get existing image details you should use get($id) method where $id is image identifier you received when you list or upload the image.
use DeDmytro\CloudflareImages\Facades\CloudflareApi;
$response = CloudflareApi::images()->get($id)
$image = $response->result;
$image->id;
$image->filename;
$image->variants->thumbnail; //Depends on your Cloudflare Images Variants setting
$image->variants->original; //Depends on your Cloudflare Images Variants setting
To delete existing image you should use delete($id) method where $id is image identifier you received when you list or upload the image.
use DeDmytro\CloudflareImages\Facades\CloudflareApi;
$response = CloudflareApi::images()->delete($id)
$response->successTo generate image url locally call method url( and pass image ID. Don't forget to set up
CLOUDFLARE_IMAGES_DELIVERY_URL=
CLOUDFLARE_IMAGES_DEFAULT_VARIATION=use DeDmytro\CloudflareImages\Facades\CloudflareApi;
$url = CloudflareApi::images()->url($id)<img src="{{ $url }}"/>