const CF_SHARED_CDN = "d3jpl91pxevbkh.cloudfront.net";

const OLD_AKAMAI_SHARED_CDN = "cloudinary-a.akamaihd.net";

const AKAMAI_SHARED_CDN = "res.cloudinary.com";

const SHARED_CDN = "res.cloudinary.com";

const BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7";

const RANGE_VALUE_RE = '/^(?P<value>(\d+\.)?\d+)(?P<modifier>[%pP])?$/';

const RANGE_RE = '/^(\d+\.)?\d+[%pP]?\.\.(\d+\.)?\d+[%pP]?$/';

const VERSION = "1.3.1";

/** @internal Do not change this value */

const USER_AGENT = "CloudinaryPHP/1.1.4";

/**

* Additional information to be passed with the USER_AGENT, e.g. "CloudinaryMagento/1.0.1". This value is set in platform-specific

* implementations that use cloudinary_php.

*

* The format of the value should be <ProductName>/Version[ (comment)].

* @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.43

*

* <b>Do not set this value in application code!</b>

*

* @var string

*/

public static $USER_PLATFORM = "";

public static $DEFAULT_RESPONSIVE_WIDTH_TRANSFORMATION = array("width"=>"auto", "crop"=>"limit");

private static $config = NULL;

public static $JS_CONFIG_PARAMS = array("api_key", "cloud_name", "private_cdn", "secure_distribution", "cdn_subdomain");

/**

* Provides the USER_AGENT string that is passed to the Cloudinary servers.

*

* Prepends {@link $USER_PLATFORM} if it is defined.

*

* @return string

*/

public static function userAgent()

{

if (self::$USER_PLATFORM == "") {

return self::USER_AGENT;

} else {

return self::$USER_PLATFORM . " " . self::USER_AGENT;

}

}

public static function is_not_null ($var) { return !is_null($var);}

public static function config($values = NULL) {

if (self::$config == NULL) {

self::reset_config();

}

if ($values != NULL) {

self::$config = array_merge(self::$config, $values);

}

return self::$config;

}

public static function reset_config() {

self::config_from_url(getenv("CLOUDINARY_URL"));

}

public static function config_from_url($cloudinary_url) {

self::$config = array();

if ($cloudinary_url) {

$uri = parse_url($cloudinary_url);

$q_params = array();

if (isset($uri["query"])) {

parse_str($uri["query"], $q_params);

}

$private_cdn = isset($uri["path"]) && $uri["path"] != "/";

$config = array_merge($q_params, array(

"cloud_name" => $uri["host"],

"api_key" => $uri["user"],

"api_secret" => $uri["pass"],

"private_cdn" => $private_cdn));

if ($private_cdn) {

$config["secure_distribution"] = substr($uri["path"], 1);

}

self::$config = array_merge(self::$config, $config);

}

}

public static function config_get($option, $default=NULL) {

return Cloudinary::option_get(self::config(), $option, $default);

}

public static function option_get($options, $option, $default=NULL) {

if (isset($options[$option])) {

return $options[$option];

} else {

return $default;

}

}

public static function option_consume(&$options, $option, $default=NULL) {

if (isset($options[$option])) {

$value = $options[$option];

unset($options[$option]);

return $value;

} else {

unset($options[$option]);

return $default;

}

}

public static function build_array($value) {

if (is_array($value) && !Cloudinary::is_assoc($value)) {

return $value;

} else if ($value === NULL) {

return array();

} else {

return array($value);

}

}

public static function encode_array($array) {

return implode(",", Cloudinary::build_array($array));

}

public static function encode_double_array($array) {

$array = Cloudinary::build_array($array);

if (count($array) > 0 && !is_array($array[0])) {

return Cloudinary::encode_array($array);

} else {

$array = array_map('Cloudinary::encode_array', $array);

}

return implode("|", $array);

}

public static function encode_assoc_array($array) {

if (Cloudinary::is_assoc($array)){

$encoded = array();

foreach ($array as $key => $value) {

array_push($encoded, $key . '=' . $value);

}

return implode("|", $encoded);

} else {

return $array;

}

}

private static function is_assoc($array) {

if (!is_array($array)) return FALSE;

return $array != array_values($array);

}

private static function generate_base_transformation($base_transformation) {

$options = is_array($base_transformation) ? $base_transformation : array("transformation"=>$base_transformation);

return Cloudinary::generate_transformation_string($options);

}

// Warning: $options are being destructively updated!

public static function generate_transformation_string(&$options=array()) {

$generate_base_transformation = "Cloudinary::generate_base_transformation";

if (is_string($options)) {

return $options;

}

if ($options == array_values($options)) {

return implode("/", array_map($generate_base_transformation, $options));

}

$responsive_width = Cloudinary::option_consume($options, "responsive_width", Cloudinary::config_get("responsive_width"));

$size = Cloudinary::option_consume($options, "size");

if ($size) list($options["width"], $options["height"]) = preg_split("/x/", $size);

$width = Cloudinary::option_get($options, "width");

$height = Cloudinary::option_get($options, "height");

$has_layer = Cloudinary::option_get($options, "underlay") || Cloudinary::option_get($options, "overlay");

$angle = implode(Cloudinary::build_array(Cloudinary::option_consume($options, "angle")), ".");

$crop = Cloudinary::option_consume($options, "crop");

$no_html_sizes = $has_layer || !empty($angle) || $crop == "fit" || $crop == "limit" || $responsive_width;

if (strlen($width) == 0 || $width && ($width == "auto" || floatval($width) < 1 || $no_html_sizes)) unset($options["width"]);

if (strlen($height) == 0 || $height && (floatval($height) < 1 || $no_html_sizes)) unset($options["height"]);

$background = Cloudinary::option_consume($options, "background");

if ($background) $background = preg_replace("/^#/", 'rgb:', $background);

$color = Cloudinary::option_consume($options, "color");

if ($color) $color = preg_replace("/^#/", 'rgb:', $color);

$base_transformations = Cloudinary::build_array(Cloudinary::option_consume($options, "transformation"));

if (count(array_filter($base_transformations, "is_array")) > 0) {

$base_transformations = array_map($generate_base_transformation, $base_transformations);

$named_transformation = "";

} else {

$named_transformation = implode(".", $base_transformations);

$base_transformations = array();

}

$effect = Cloudinary::option_consume($options, "effect");

if (is_array($effect)) $effect = implode(":", $effect);

$border = Cloudinary::process_border(Cloudinary::option_consume($options, "border"));

$flags = implode(Cloudinary::build_array(Cloudinary::option_consume($options, "flags")), ".");

$dpr = Cloudinary::option_consume($options, "dpr", Cloudinary::config_get("dpr"));

$duration = Cloudinary::norm_range_value(Cloudinary::option_consume($options, "duration"));

$start_offset = Cloudinary::norm_range_value(Cloudinary::option_consume($options, "start_offset"));

$end_offset = Cloudinary::norm_range_value(Cloudinary::option_consume($options, "end_offset"));

$offset = Cloudinary::split_range(Cloudinary::option_consume($options, "offset"));

if (!empty($offset)) {

$start_offset = Cloudinary::norm_range_value($offset[0]);

$end_offset = Cloudinary::norm_range_value($offset[1]);

}

$video_codec = Cloudinary::process_video_codec_param(Cloudinary::option_consume($options, "video_codec"));

$overlay = Cloudinary::process_layer(Cloudinary::option_consume($options, "overlay"), "overlay");

$underlay = Cloudinary::process_layer(Cloudinary::option_consume($options, "underlay"), "underlay");

$if = Cloudinary::process_if(Cloudinary::option_consume($options, "if"));

$params = array(

"a" => $angle,

"b" => $background,

"bo" => $border,

"c" => $crop,

"co" => $color,

"dpr" => $dpr,

"du" => $duration,

"e" => $effect,

"eo" => $end_offset,

"fl" => $flags,

"h" => $height,

"l" => $overlay,

"so" => $start_offset,

"t" => $named_transformation,

"u" => $underlay,

"vc" => $video_codec,

"w" => $width);

$simple_params = array(

"ac" => "audio_codec",

"af" => "audio_frequency",

"ar" => "aspect_ratio",

"br" => "bit_rate",

"cs" => "color_space",

"d" => "default_image",

"dl" => "delay",

"dn" => "density",

"f" => "fetch_format",

"g" => "gravity",

"o" => "opacity",

"p" => "prefix",

"pg" => "page",

"q" => "quality",

"r" => "radius",

"vs" => "video_sampling",

"x" => "x",

"y" => "y",

"z" => "zoom"

);

foreach ($simple_params as $param=>$option) {

$params[$param] = Cloudinary::option_consume($options, $option);

}

$param_filter = function($value) { return $value === 0 || $value === '0' || trim($value) == true; };

$params = array_filter($params, $param_filter);

ksort($params);

if (isset($if)) {

$params = array_merge(array("if"=>$if), $params);

}

$join_pair = function($key, $value) { return $key . "_" . $value; };

$transformation = implode(",", array_map($join_pair, array_keys($params), array_values($params)));

$raw_transformation = Cloudinary::option_consume($options, "raw_transformation");

$transformation = implode(",", array_filter(array($transformation, $raw_transformation)));

array_push($base_transformations, $transformation);

if ($responsive_width) {

$responsive_width_transformation = Cloudinary::config_get("responsive_width_transformation", Cloudinary::$DEFAULT_RESPONSIVE_WIDTH_TRANSFORMATION);

array_push($base_transformations, Cloudinary::generate_transformation_string($responsive_width_transformation));

}

if ($width == "auto" || $responsive_width) {

$options["responsive"] = true;

}

if ($dpr == "auto") {

$options["hidpi"] = true;

}

return implode("/", array_filter($base_transformations));

}

private static $LAYER_KEYWORD_PARAMS = array(

"font_weight"=>"normal", "font_style"=>"normal", "text_decoration"=>"none", "text_align"=>NULL, "stroke"=>"none"

);

private static function text_style( $layer, $layer_parameter) {

$font_family = Cloudinary::option_get($layer, "font_family");

$font_size = Cloudinary::option_get($layer, "font_size");

$keywords = array();

foreach (Cloudinary::$LAYER_KEYWORD_PARAMS as $attr=>$default_value) {

$attr_value = Cloudinary::option_get($layer, $attr, $default_value);

if ($attr_value != $default_value) {

array_push($keywords, $attr_value);

}

}

$letter_spacing = Cloudinary::option_get($layer, "letter_spacing");

if ($letter_spacing != NULL) {

array_push($keywords, "letter_spacing_$letter_spacing");

}

$line_spacing = Cloudinary::option_get($layer, "line_spacing");

if ($line_spacing != NULL) {

array_push($keywords, "line_spacing_$line_spacing");

}

$has_text_options = $font_size != NULL || $font_family != NULL || !empty($keywords);

if (!$has_text_options) {

return NULL;

}

if ($font_family == NULL) {

throw new InvalidArgumentException("Must supply font_family for text in $layer_parameter");

}

if ($font_size == NULL) {

throw new InvalidArgumentException("Must supply font_size for text in $layer_parameter");

}

array_unshift($keywords, $font_size);

array_unshift($keywords, $font_family);

return implode("_", array_filter($keywords, 'Cloudinary::is_not_null'));

}

private static function process_layer($layer, $layer_parameter) {

if (is_array($layer)) {

$resource_type = Cloudinary::option_get($layer, "resource_type");

$type = Cloudinary::option_get($layer, "type");

$text = Cloudinary::option_get($layer, "text");

$text_style = NULL;

$public_id = Cloudinary::option_get($layer, "public_id");

$format = Cloudinary::option_get($layer, "format");

$components = array();

if ($public_id != NULL){

$public_id = str_replace("/", ":", $public_id);

if($format != NULL) $public_id = $public_id . "." . $format;

}

if ($text == NULL && $resource_type != "text"){

if ($public_id == NULL) {

throw new InvalidArgumentException("Must supply public_id for $resource_type $layer_parameter");

}

if($resource_type == "subtitles") {

$text_style = Cloudinary::text_style($layer, $layer_parameter);

}

} else {

$resource_type = "text";

$type = NULL; // type is ignored for text layers

$text_style = Cloudinary::text_style($layer, $layer_parameter); #FIXME duplicate

if($text != NULL) {

if(!($public_id != NULL xor $text_style != NULL)) {

throw new InvalidArgumentException("Must supply either style parameters or a public_id when providing text parameter in a text $layer_parameter");

}

$text = Cloudinary::smart_escape($text);

$text = str_replace("%2C", "%252C", $text);

$text = str_replace("/", "%252F", $text);

}

}

if($resource_type != "image") array_push($components, $resource_type);

if($type != "upload") array_push($components, $type);

array_push($components, $text_style);

array_push($components, $public_id);

array_push($components, $text);

$layer = implode(":", array_filter($components, 'Cloudinary::is_not_null'));

}

return $layer;

}

private static $IF_OPERATORS = array(

"=" => 'eq',

"!=" => 'ne',

"<" => 'lt',

">" => 'gt',

"<=" => 'lte',

">=" => 'gte',

"&&" => 'and',

"||" => 'or');

private static $IF_PARAMETERS = array(

"width" => 'w',

"height" => 'h',

"page_count" => "pc",

"face_count" => "fc",

"aspect_ratio" => "ar"

);

private static function translate_if( $source )

{

if (isset(self::$IF_OPERATORS[$source[0]])) {

return self::$IF_OPERATORS[$source[0]];

} elseif (isset(self::$IF_PARAMETERS[$source[0]])) {

return self::$IF_PARAMETERS[$source[0]];

} else {

return $source[0];

}

}

private static $IF_REPLACE_RE;

private static function process_if($if) {

if (empty(self::$IF_REPLACE_RE)) {

self::$IF_REPLACE_RE = '/(' . implode('|', array_keys(self::$IF_PARAMETERS)) . '|[=<>&|!]+)/';

}

if (isset($if)) {

$if = preg_replace('/[ _]+/', '_', $if);

$if = preg_replace_callback(self::$IF_REPLACE_RE, array("Cloudinary", "translate_if"), $if);

}

return $if;

}

private static function process_border($border) {

if (is_array($border)) {

$border_width = Cloudinary::option_get($border, "width", "2");

$border_color = preg_replace("/^#/", 'rgb:', Cloudinary::option_get($border, "color", "black"));

$border = $border_width . "px_solid_" . $border_color;

}

return $border;

}

private static function split_range($range) {

if (is_array($range) && count($range) >= 2) {

return array($range[0], end($range));

} else if (is_string($range) && preg_match(Cloudinary::RANGE_RE, $range) == 1) {

return explode("..", $range, 2);

} else {

return NULL;

}

}

private static function norm_range_value($value) {

if (empty($value)) {

return NULL;

}

preg_match(Cloudinary::RANGE_VALUE_RE, $value, $matches);

if (empty($matches)) {

return NULL;

}

$modifier = '';

if (!empty($matches['modifier'])) {

$modifier = 'p';

}

return $matches['value'] . $modifier;

}

private static function process_video_codec_param($param) {

$out_param = $param;

if (is_array($out_param)) {

$out_param = $param['codec'];

if (array_key_exists('profile', $param)) {

$out_param = $out_param . ':' . $param['profile'];

if (array_key_exists('level', $param)) {

$out_param = $out_param . ':' . $param['level'];

}

}

}

return $out_param;

}

// Warning: $options are being destructively updated!

public static function cloudinary_url($source, &$options=array()) {

$source = self::check_cloudinary_field($source, $options);

$type = Cloudinary::option_consume($options, "type", "upload");

if ($type == "fetch" && !isset($options["fetch_format"])) {

$options["fetch_format"] = Cloudinary::option_consume($options, "format");

}

$transformation = Cloudinary::generate_transformation_string($options);

$resource_type = Cloudinary::option_consume($options, "resource_type", "image");

$version = Cloudinary::option_consume($options, "version");

$format = Cloudinary::option_consume($options, "format");

$cloud_name = Cloudinary::option_consume($options, "cloud_name", Cloudinary::config_get("cloud_name"));

if (!$cloud_name) throw new InvalidArgumentException("Must supply cloud_name in tag or in configuration");

$secure = Cloudinary::option_consume($options, "secure", Cloudinary::config_get("secure"));

$private_cdn = Cloudinary::option_consume($options, "private_cdn", Cloudinary::config_get("private_cdn"));

$secure_distribution = Cloudinary::option_consume($options, "secure_distribution", Cloudinary::config_get("secure_distribution"));

$cdn_subdomain = Cloudinary::option_consume($options, "cdn_subdomain", Cloudinary::config_get("cdn_subdomain"));

$secure_cdn_subdomain = Cloudinary::option_consume($options, "secure_cdn_subdomain", Cloudinary::config_get("secure_cdn_subdomain"));

$cname = Cloudinary::option_consume($options, "cname", Cloudinary::config_get("cname"));

$shorten = Cloudinary::option_consume($options, "shorten", Cloudinary::config_get("shorten"));

$sign_url = Cloudinary::option_consume($options, "sign_url", Cloudinary::config_get("sign_url"));

$api_secret = Cloudinary::option_consume($options, "api_secret", Cloudinary::config_get("api_secret"));

$url_suffix = Cloudinary::option_consume($options, "url_suffix", Cloudinary::config_get("url_suffix"));

$use_root_path = Cloudinary::option_consume($options, "use_root_path", Cloudinary::config_get("use_root_path"));

if (!$private_cdn and !empty($url_suffix)) {

throw new InvalidArgumentException("URL Suffix only supported in private CDN");

}

if (!$source) return $source;

if (preg_match("/^https?:\//i", $source)) {

if ($type == "upload") return $source;

}

$resource_type_and_type = Cloudinary::finalize_resource_type($resource_type, $type, $url_suffix, $use_root_path, $shorten);

$sources = Cloudinary::finalize_source($source, $format, $url_suffix);

$source = $sources["source"];

$source_to_sign = $sources["source_to_sign"];

if (strpos($source_to_sign, "/") && !preg_match("/^https?:\//", $source_to_sign) && !preg_match("/^v[0-9]+/", $source_to_sign) && empty($version)) {

$version = "1";

}

$version = $version ? "v" . $version : NULL;

$signature = NULL;

if ($sign_url) {

$to_sign = implode("/", array_filter(array($transformation, $source_to_sign)));

$signature = str_replace(array('+','/','='), array('-','_',''), base64_encode(sha1($to_sign . $api_secret, TRUE)));

$signature = 's--' . substr($signature, 0, 8) . '--';

}

$prefix = Cloudinary::unsigned_download_url_prefix($source, $cloud_name, $private_cdn, $cdn_subdomain, $secure_cdn_subdomain,

$cname, $secure, $secure_distribution);

return preg_replace("/([^:])\/+/", "$1/", implode("/", array_filter(array($prefix, $resource_type_and_type,

$signature, $transformation, $version, $source))));

}

private static function finalize_source($source, $format, $url_suffix) {

$source = preg_replace('/([^:])\/\//', '$1/', $source);

if (preg_match('/^https?:\//i', $source)) {

$source = Cloudinary::smart_escape($source);

$source_to_sign = $source;

} else {

$source = Cloudinary::smart_escape(rawurldecode($source));

$source_to_sign = $source;

if (!empty($url_suffix)) {

if (preg_match('/[\.\/]/i', $url_suffix)) throw new InvalidArgumentException("url_suffix should not include . or /");

$source = $source . '/' . $url_suffix;

}

if (!empty($format)) {

$source = $source . '.' . $format ;

$source_to_sign = $source_to_sign . '.' . $format ;

}

}

return array("source" => $source, "source_to_sign" => $source_to_sign);

}

private static function finalize_resource_type($resource_type, $type, $url_suffix, $use_root_path, $shorten) {

if (empty($type)) {

$type = "upload";

}

if (!empty($url_suffix)) {

if ($resource_type == "image" && $type == "upload") {

$resource_type = "images";

$type = NULL;

} else if ($resource_type == "raw" && $type == "upload") {

$resource_type = "files";

$type = NULL;

} else {

throw new InvalidArgumentException("URL Suffix only supported for image/upload and raw/upload");

}

}

if ($use_root_path) {

if (($resource_type == "image" && $type == "upload") || ($resource_type == "images" && empty($type))) {

$resource_type = NULL;

$type = NULL;

} else {

throw new InvalidArgumentException("Root path only supported for image/upload");

}

}

if ($shorten && $resource_type == "image" && $type == "upload") {

$resource_type = "iu";

$type = NULL;

}

$out = "";

if (!empty($resource_type)) {

$out = $resource_type;

}

if (!empty($type)) {

$out = $out . '/' . $type;

}

return $out;

}

// cdn_subdomain and secure_cdn_subdomain

// 1) Customers in shared distribution (e.g. res.cloudinary.com)

// if cdn_domain is true uses res-[1-5].cloudinary.com for both http and https. Setting secure_cdn_subdomain to false disables this for https.

// 2) Customers with private cdn

// if cdn_domain is true uses cloudname-res-[1-5].cloudinary.com for http

// if secure_cdn_domain is true uses cloudname-res-[1-5].cloudinary.com for https (please contact support if you require this)

// 3) Customers with cname

// if cdn_domain is true uses a[1-5].cname for http. For https, uses the same naming scheme as 1 for shared distribution and as 2 for private distribution.

private static function unsigned_download_url_prefix($source, $cloud_name, $private_cdn, $cdn_subdomain, $secure_cdn_subdomain, $cname, $secure, $secure_distribution) {

$shared_domain = !$private_cdn;

$prefix = NULL;

if ($secure) {

if (empty($secure_distribution) || $secure_distribution == Cloudinary::OLD_AKAMAI_SHARED_CDN) {

$secure_distribution = $private_cdn ? $cloud_name . '-res.cloudinary.com' : Cloudinary::SHARED_CDN;

}

if (empty($shared_domain)) {

$shared_domain = ($secure_distribution == Cloudinary::SHARED_CDN);

}

if (is_null($secure_cdn_subdomain) && $shared_domain) {

$secure_cdn_subdomain = $cdn_subdomain ;

}

if ($secure_cdn_subdomain) {

$secure_distribution = str_replace('res.cloudinary.com', "res-" . Cloudinary::domain_shard($source) . ".cloudinary.com", $secure_distribution);

}

$prefix = "https://" . $secure_distribution;

} else if ($cname) {

$subdomain = $cdn_subdomain ? "a" . Cloudinary::domain_shard($source) . '.' : "";

$prefix = "http://" . $subdomain . $cname;

} else {

$host = implode(array($private_cdn ? $cloud_name . "-" : "", "res", $cdn_subdomain ? "-" . Cloudinary::domain_shard($source) : "", ".cloudinary.com"));

$prefix = "http://" . $host;

}

if ($shared_domain) {

$prefix = $prefix . '/' . $cloud_name;

}

return $prefix;

}

private static function domain_shard($source) {

return (((crc32($source) % 5) + 5) % 5 + 1);

}

// [<resource_type>/][<image_type>/][v<version>/]<public_id>[.<format>][#<signature>]

// Warning: $options are being destructively updated!

public static function check_cloudinary_field($source, &$options=array()) {

$IDENTIFIER_RE = "~" .

"^(?:([^/]+)/)??(?:([^/]+)/)??(?:(?:v(\\d+)/)(?:([^#]+)/)?)?" .

"([^#/]+?)(?:\\.([^.#/]+))?(?:#([^/]+))?$" .

"~";

$matches = array();

if (!(is_object($source) && method_exists($source, 'identifier'))) {

return $source;

}

$identifier = $source->identifier();

if (!$identifier || strstr(':', $identifier) !== false || !preg_match($IDENTIFIER_RE, $identifier, $matches)) {

return $source;

}

$optionNames = array('resource_type', 'type', 'version', 'folder', 'public_id', 'format');

foreach ($optionNames as $index => $optionName) {

if (@$matches[$index+1]) {

$options[$optionName] = $matches[$index+1];

}

}

return Cloudinary::option_consume($options, 'public_id');

}

// Based on http://stackoverflow.com/a/1734255/526985

private static function smart_escape($str) {

$revert = array('%21'=>'!', '%2A'=>'*', '%27'=>"'", '%3A'=>':', '%2F'=>'/');

return strtr(rawurlencode($str), $revert);

}

public static function cloudinary_api_url($action = 'upload', $options = array()) {

$cloudinary = Cloudinary::option_get($options, "upload_prefix", Cloudinary::config_get("upload_prefix", "https://api.cloudinary.com"));

$cloud_name = Cloudinary::config_get("cloud_name");

if (!$cloud_name) throw new InvalidArgumentException("Must supply cloud_name in tag or in configuration");

$resource_type = Cloudinary::option_get($options, "resource_type", "image");

return implode("/", array($cloudinary, "v1_1", $cloud_name, $resource_type, $action));

}

public static function random_public_id() {

return substr(sha1(uniqid(Cloudinary::config_get("api_secret", "") . mt_rand())), 0, 16);

}

public static function signed_preloaded_image($result) {

return $result["resource_type"] . "/upload/v" . $result["version"] . "/" . $result["public_id"] .

(isset($result["format"]) ? "." . $result["format"] : "") . "#" . $result["signature"];

}

# Utility method that uses the deprecated ZIP download API.

# @deprecated Replaced by {download_zip_url} that uses the more advanced and robust archive generation and download API

public static function zip_download_url($tag, $options=array()) {

$params = array("timestamp"=>time(), "tag"=>$tag, "transformation" => \Cloudinary::generate_transformation_string($options));

$params = Cloudinary::sign_request($params, $options);

return Cloudinary::cloudinary_api_url("download_tag.zip", $options) . "?" . http_build_query($params);

}

# Returns a URL that when invokes creates an archive and returns it.

# @param options [Hash]

# @option options [String] resource_type The resource type of files to include in the archive. Must be one of image | video | raw

# @option options [String] type (upload) The specific file type of resources upload|private|authenticated

# @option options [String|Array] tags (nil) list of tags to include in the archive

# @option options [String|Array<String>] public_ids (nil) list of public_ids to include in the archive

# @option options [String|Array<String>] prefixes (nil) Optional list of prefixes of public IDs (e.g., folders).

# @option options [String|Array<String>] transformations Optional list of transformations.

# The derived images of the given transformations are included in the archive. Using the string representation of

# multiple chained transformations as we use for the 'eager' upload parameter.

# @option options [String] mode (create) return the generated archive file or to store it as a raw resource and

# return a JSON with URLs for accessing the archive. Possible values download, create

# @option options [String] target_format (zip)

# @option options [String] target_public_id Optional public ID of the generated raw resource.

# Relevant only for the create mode. If not specified, random public ID is generated.

# @option options [boolean] flatten_folders (false) If true, flatten public IDs with folders to be in the root of the archive.

# Add numeric counter to the file name in case of a name conflict.

# @option options [boolean] flatten_transformations (false) If true, and multiple transformations are given,

# flatten the folder structure of derived images and store the transformation details on the file name instead.

# @option options [boolean] use_original_filename Use the original file name of included images (if available) instead of the public ID.

# @option options [boolean] async (false) If true, return immediately and perform the archive creation in the background.

# Relevant only for the create mode.

# @option options [String] notification_url Optional URL to send an HTTP post request (webhook) when the archive creation is completed.

# @option options [String|Array<String] target_tags Optional array. Allows assigning one or more tag to the generated archive file (for later housekeeping via the admin API).

# @option options [String] keep_derived (false) keep the derived images used for generating the archive

# @return [String] archive url

public static function download_archive_url($options=array()) {

$options["mode"] = "download";

$params = Cloudinary::build_archive_params($options);

$params = Cloudinary::sign_request($params, $options);

return Cloudinary::cloudinary_api_url("generate_archive", $options) . "?" . preg_replace("/%5B\d+%5D/", "%5B%5D", http_build_query($params));

}

# Returns a URL that when invokes creates an zip archive and returns it.

# @see download_archive_url

public static function download_zip_url($options=array()) {

$options["target_format"] = "zip";

return Cloudinary::download_archive_url($options);

}

# Returns a Hash of parameters used to create an archive

# @param [Hash] options

# @private

public static function build_archive_params(&$options)

{

$params = array("timestamp" => time(),

"type" => \Cloudinary::option_get($options, "type"),

"mode" => \Cloudinary::option_get($options, "mode"),

"target_format" => \Cloudinary::option_get($options, "target_format"),

"target_public_id" => \Cloudinary::option_get($options, "target_public_id"),

"flatten_folders" => \Cloudinary::option_get($options, "flatten_folders"),

"flatten_transformations" => \Cloudinary::option_get($options, "flatten_transformations"),

"use_original_filename" => \Cloudinary::option_get($options, "use_original_filename"),

"async" => \Cloudinary::option_get($options, "async"),

"phash" => \Cloudinary::option_get($options, "phash"),

"notification_url" => \Cloudinary::option_get($options, "notification_url"),

"target_tags" => \Cloudinary::build_array(\Cloudinary::option_get($options, "target_tags")),

"keep_derived" => \Cloudinary::option_get($options, "keep_derived"),

"tags" => \Cloudinary::build_array(\Cloudinary::option_get($options, "tags")),

"public_ids" => \Cloudinary::build_array(\Cloudinary::option_get($options, "public_ids")),

"prefixes" => \Cloudinary::build_array(\Cloudinary::option_get($options, "prefixes")),

"transformations" => \Cloudinary::build_eager(\Cloudinary::option_get($options, "transformations")),

);

array_walk($params, function (&$value, $key){ $value = (is_bool($value) ? ($value ? "1" : "0") : $value);});

return array_filter($params,function($v){ return !is_null($v) && ($v !== "" );});

}

public static function build_eager($transformations) {

$eager = array();

foreach (\Cloudinary::build_array($transformations) as $trans) {

$transformation = $trans;

$format = \Cloudinary::option_consume($transformation, "format");

$single_eager = implode("/", array_filter(array(\Cloudinary::generate_transformation_string($transformation), $format)));

array_push($eager, $single_eager);

}

return implode("|", $eager);

}

public static function private_download_url($public_id, $format, $options = array()) {

$cloudinary_params = Cloudinary::sign_request(array(

"timestamp"=>time(),

"public_id"=>$public_id,

"format"=>$format,

"type"=>Cloudinary::option_get($options, "type"),

"attachment"=>Cloudinary::option_get($options, "attachment"),

"expires_at"=>Cloudinary::option_get($options, "expires_at")

), $options);

return Cloudinary::cloudinary_api_url("download", $options) . "?" . http_build_query($cloudinary_params);

}

public static function sign_request($params, &$options) {

$api_key = Cloudinary::option_get($options, "api_key", Cloudinary::config_get("api_key"));

if (!$api_key) throw new \InvalidArgumentException("Must supply api_key");

$api_secret = Cloudinary::option_get($options, "api_secret", Cloudinary::config_get("api_secret"));

if (!$api_secret) throw new \InvalidArgumentException("Must supply api_secret");

# Remove blank parameters

$params = array_filter($params, function($v){ return isset($v) && $v !== "";});

$params["signature"] = Cloudinary::api_sign_request($params, $api_secret);

$params["api_key"] = $api_key;

return $params;

}

public static function api_sign_request($params_to_sign, $api_secret) {

$params = array();

foreach ($params_to_sign as $param => $value) {

if (isset($value) && $value !== "") {

if (!is_array($value)) {

$params[$param] = $value;

} else if (count($value) > 0) {

$params[$param] = implode(",", $value);

}

}

}

ksort($params);

$join_pair = function($key, $value) { return $key . "=" . $value; };

$to_sign = implode("&", array_map($join_pair, array_keys($params), array_values($params)));

return sha1($to_sign . $api_secret);

}

public static function html_attrs($options, $only = NULL) {

$attrs = array();

foreach($options as $k => $v) {

$key = $k;

$value = $v;

if (is_int($k)) {

$key = $v;

$value = "";

}

if (is_array($only) && array_search($key, $only) !== FALSE || !is_array($only)) {

$attrs[$key] = $value;

}

}

ksort($attrs);

$join_pair = function($key, $value) {

$out = $key;

if (!empty($value)) {

$out .= '=\'' . $value . '\'';

}

return $out;

};

return implode(" ", array_map($join_pair, array_keys($attrs), array_values($attrs)));

}