summaryrefslogtreecommitdiffstats
path: root/vendor/stripe/stripe-php/lib/Util/Util.php
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/stripe/stripe-php/lib/Util/Util.php')
-rw-r--r--vendor/stripe/stripe-php/lib/Util/Util.php530
1 files changed, 265 insertions, 265 deletions
diff --git a/vendor/stripe/stripe-php/lib/Util/Util.php b/vendor/stripe/stripe-php/lib/Util/Util.php
index 4f39050..602f466 100644
--- a/vendor/stripe/stripe-php/lib/Util/Util.php
+++ b/vendor/stripe/stripe-php/lib/Util/Util.php
@@ -1,265 +1,265 @@
-<?php
-
-namespace Stripe\Util;
-
-use Stripe\StripeObject;
-
-abstract class Util
-{
- private static $isMbstringAvailable = null;
- private static $isHashEqualsAvailable = null;
-
- /**
- * Whether the provided array (or other) is a list rather than a dictionary.
- * A list is defined as an array for which all the keys are consecutive
- * integers starting at 0. Empty arrays are considered to be lists.
- *
- * @param array|mixed $array
- *
- * @return bool true if the given object is a list
- */
- public static function isList($array)
- {
- if (!\is_array($array)) {
- return false;
- }
- if ([] === $array) {
- return true;
- }
- if (\array_keys($array) !== \range(0, \count($array) - 1)) {
- return false;
- }
-
- return true;
- }
-
- /**
- * Converts a response from the Stripe API to the corresponding PHP object.
- *
- * @param array $resp the response from the Stripe API
- * @param array $opts
- *
- * @return array|StripeObject
- */
- public static function convertToStripeObject($resp, $opts)
- {
- $types = \Stripe\Util\ObjectTypes::mapping;
- if (self::isList($resp)) {
- $mapped = [];
- foreach ($resp as $i) {
- $mapped[] = self::convertToStripeObject($i, $opts);
- }
-
- return $mapped;
- }
- if (\is_array($resp)) {
- if (isset($resp['object']) && \is_string($resp['object']) && isset($types[$resp['object']])) {
- $class = $types[$resp['object']];
- } else {
- $class = \Stripe\StripeObject::class;
- }
-
- return $class::constructFrom($resp, $opts);
- }
-
- return $resp;
- }
-
- /**
- * @param mixed|string $value a string to UTF8-encode
- *
- * @return mixed|string the UTF8-encoded string, or the object passed in if
- * it wasn't a string
- */
- public static function utf8($value)
- {
- if (null === self::$isMbstringAvailable) {
- self::$isMbstringAvailable = \function_exists('mb_detect_encoding');
-
- if (!self::$isMbstringAvailable) {
- \trigger_error('It looks like the mbstring extension is not enabled. ' .
- 'UTF-8 strings will not properly be encoded. Ask your system ' .
- 'administrator to enable the mbstring extension, or write to ' .
- 'support@stripe.com if you have any questions.', \E_USER_WARNING);
- }
- }
-
- if (\is_string($value) && self::$isMbstringAvailable && 'UTF-8' !== \mb_detect_encoding($value, 'UTF-8', true)) {
- return \utf8_encode($value);
- }
-
- return $value;
- }
-
- /**
- * Compares two strings for equality. The time taken is independent of the
- * number of characters that match.
- *
- * @param string $a one of the strings to compare
- * @param string $b the other string to compare
- *
- * @return bool true if the strings are equal, false otherwise
- */
- public static function secureCompare($a, $b)
- {
- if (null === self::$isHashEqualsAvailable) {
- self::$isHashEqualsAvailable = \function_exists('hash_equals');
- }
-
- if (self::$isHashEqualsAvailable) {
- return \hash_equals($a, $b);
- }
- if (\strlen($a) !== \strlen($b)) {
- return false;
- }
-
- $result = 0;
- for ($i = 0; $i < \strlen($a); ++$i) {
- $result |= \ord($a[$i]) ^ \ord($b[$i]);
- }
-
- return 0 === $result;
- }
-
- /**
- * Recursively goes through an array of parameters. If a parameter is an instance of
- * ApiResource, then it is replaced by the resource's ID.
- * Also clears out null values.
- *
- * @param mixed $h
- *
- * @return mixed
- */
- public static function objectsToIds($h)
- {
- if ($h instanceof \Stripe\ApiResource) {
- return $h->id;
- }
- if (static::isList($h)) {
- $results = [];
- foreach ($h as $v) {
- $results[] = static::objectsToIds($v);
- }
-
- return $results;
- }
- if (\is_array($h)) {
- $results = [];
- foreach ($h as $k => $v) {
- if (null === $v) {
- continue;
- }
- $results[$k] = static::objectsToIds($v);
- }
-
- return $results;
- }
-
- return $h;
- }
-
- /**
- * @param array $params
- *
- * @return string
- */
- public static function encodeParameters($params)
- {
- $flattenedParams = self::flattenParams($params);
- $pieces = [];
- foreach ($flattenedParams as $param) {
- list($k, $v) = $param;
- $pieces[] = self::urlEncode($k) . '=' . self::urlEncode($v);
- }
-
- return \implode('&', $pieces);
- }
-
- /**
- * @param array $params
- * @param null|string $parentKey
- *
- * @return array
- */
- public static function flattenParams($params, $parentKey = null)
- {
- $result = [];
-
- foreach ($params as $key => $value) {
- $calculatedKey = $parentKey ? "{$parentKey}[{$key}]" : $key;
-
- if (self::isList($value)) {
- $result = \array_merge($result, self::flattenParamsList($value, $calculatedKey));
- } elseif (\is_array($value)) {
- $result = \array_merge($result, self::flattenParams($value, $calculatedKey));
- } else {
- \array_push($result, [$calculatedKey, $value]);
- }
- }
-
- return $result;
- }
-
- /**
- * @param array $value
- * @param string $calculatedKey
- *
- * @return array
- */
- public static function flattenParamsList($value, $calculatedKey)
- {
- $result = [];
-
- foreach ($value as $i => $elem) {
- if (self::isList($elem)) {
- $result = \array_merge($result, self::flattenParamsList($elem, $calculatedKey));
- } elseif (\is_array($elem)) {
- $result = \array_merge($result, self::flattenParams($elem, "{$calculatedKey}[{$i}]"));
- } else {
- \array_push($result, ["{$calculatedKey}[{$i}]", $elem]);
- }
- }
-
- return $result;
- }
-
- /**
- * @param string $key a string to URL-encode
- *
- * @return string the URL-encoded string
- */
- public static function urlEncode($key)
- {
- $s = \urlencode((string) $key);
-
- // Don't use strict form encoding by changing the square bracket control
- // characters back to their literals. This is fine by the server, and
- // makes these parameter strings easier to read.
- $s = \str_replace('%5B', '[', $s);
-
- return \str_replace('%5D', ']', $s);
- }
-
- public static function normalizeId($id)
- {
- if (\is_array($id)) {
- $params = $id;
- $id = $params['id'];
- unset($params['id']);
- } else {
- $params = [];
- }
-
- return [$id, $params];
- }
-
- /**
- * Returns UNIX timestamp in milliseconds.
- *
- * @return int current time in millis
- */
- public static function currentTimeMillis()
- {
- return (int) \round(\microtime(true) * 1000);
- }
-}
+<?php
+
+namespace Stripe\Util;
+
+use Stripe\StripeObject;
+
+abstract class Util
+{
+ private static $isMbstringAvailable = null;
+ private static $isHashEqualsAvailable = null;
+
+ /**
+ * Whether the provided array (or other) is a list rather than a dictionary.
+ * A list is defined as an array for which all the keys are consecutive
+ * integers starting at 0. Empty arrays are considered to be lists.
+ *
+ * @param array|mixed $array
+ *
+ * @return bool true if the given object is a list
+ */
+ public static function isList($array)
+ {
+ if (!\is_array($array)) {
+ return false;
+ }
+ if ([] === $array) {
+ return true;
+ }
+ if (\array_keys($array) !== \range(0, \count($array) - 1)) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Converts a response from the Stripe API to the corresponding PHP object.
+ *
+ * @param array $resp the response from the Stripe API
+ * @param array $opts
+ *
+ * @return array|StripeObject
+ */
+ public static function convertToStripeObject($resp, $opts)
+ {
+ $types = \Stripe\Util\ObjectTypes::mapping;
+ if (self::isList($resp)) {
+ $mapped = [];
+ foreach ($resp as $i) {
+ $mapped[] = self::convertToStripeObject($i, $opts);
+ }
+
+ return $mapped;
+ }
+ if (\is_array($resp)) {
+ if (isset($resp['object']) && \is_string($resp['object']) && isset($types[$resp['object']])) {
+ $class = $types[$resp['object']];
+ } else {
+ $class = \Stripe\StripeObject::class;
+ }
+
+ return $class::constructFrom($resp, $opts);
+ }
+
+ return $resp;
+ }
+
+ /**
+ * @param mixed|string $value a string to UTF8-encode
+ *
+ * @return mixed|string the UTF8-encoded string, or the object passed in if
+ * it wasn't a string
+ */
+ public static function utf8($value)
+ {
+ if (null === self::$isMbstringAvailable) {
+ self::$isMbstringAvailable = \function_exists('mb_detect_encoding');
+
+ if (!self::$isMbstringAvailable) {
+ \trigger_error('It looks like the mbstring extension is not enabled. ' .
+ 'UTF-8 strings will not properly be encoded. Ask your system ' .
+ 'administrator to enable the mbstring extension, or write to ' .
+ 'support@stripe.com if you have any questions.', \E_USER_WARNING);
+ }
+ }
+
+ if (\is_string($value) && self::$isMbstringAvailable && 'UTF-8' !== \mb_detect_encoding($value, 'UTF-8', true)) {
+ return \utf8_encode($value);
+ }
+
+ return $value;
+ }
+
+ /**
+ * Compares two strings for equality. The time taken is independent of the
+ * number of characters that match.
+ *
+ * @param string $a one of the strings to compare
+ * @param string $b the other string to compare
+ *
+ * @return bool true if the strings are equal, false otherwise
+ */
+ public static function secureCompare($a, $b)
+ {
+ if (null === self::$isHashEqualsAvailable) {
+ self::$isHashEqualsAvailable = \function_exists('hash_equals');
+ }
+
+ if (self::$isHashEqualsAvailable) {
+ return \hash_equals($a, $b);
+ }
+ if (\strlen($a) !== \strlen($b)) {
+ return false;
+ }
+
+ $result = 0;
+ for ($i = 0; $i < \strlen($a); ++$i) {
+ $result |= \ord($a[$i]) ^ \ord($b[$i]);
+ }
+
+ return 0 === $result;
+ }
+
+ /**
+ * Recursively goes through an array of parameters. If a parameter is an instance of
+ * ApiResource, then it is replaced by the resource's ID.
+ * Also clears out null values.
+ *
+ * @param mixed $h
+ *
+ * @return mixed
+ */
+ public static function objectsToIds($h)
+ {
+ if ($h instanceof \Stripe\ApiResource) {
+ return $h->id;
+ }
+ if (static::isList($h)) {
+ $results = [];
+ foreach ($h as $v) {
+ $results[] = static::objectsToIds($v);
+ }
+
+ return $results;
+ }
+ if (\is_array($h)) {
+ $results = [];
+ foreach ($h as $k => $v) {
+ if (null === $v) {
+ continue;
+ }
+ $results[$k] = static::objectsToIds($v);
+ }
+
+ return $results;
+ }
+
+ return $h;
+ }
+
+ /**
+ * @param array $params
+ *
+ * @return string
+ */
+ public static function encodeParameters($params)
+ {
+ $flattenedParams = self::flattenParams($params);
+ $pieces = [];
+ foreach ($flattenedParams as $param) {
+ list($k, $v) = $param;
+ $pieces[] = self::urlEncode($k) . '=' . self::urlEncode($v);
+ }
+
+ return \implode('&', $pieces);
+ }
+
+ /**
+ * @param array $params
+ * @param null|string $parentKey
+ *
+ * @return array
+ */
+ public static function flattenParams($params, $parentKey = null)
+ {
+ $result = [];
+
+ foreach ($params as $key => $value) {
+ $calculatedKey = $parentKey ? "{$parentKey}[{$key}]" : $key;
+
+ if (self::isList($value)) {
+ $result = \array_merge($result, self::flattenParamsList($value, $calculatedKey));
+ } elseif (\is_array($value)) {
+ $result = \array_merge($result, self::flattenParams($value, $calculatedKey));
+ } else {
+ \array_push($result, [$calculatedKey, $value]);
+ }
+ }
+
+ return $result;
+ }
+
+ /**
+ * @param array $value
+ * @param string $calculatedKey
+ *
+ * @return array
+ */
+ public static function flattenParamsList($value, $calculatedKey)
+ {
+ $result = [];
+
+ foreach ($value as $i => $elem) {
+ if (self::isList($elem)) {
+ $result = \array_merge($result, self::flattenParamsList($elem, $calculatedKey));
+ } elseif (\is_array($elem)) {
+ $result = \array_merge($result, self::flattenParams($elem, "{$calculatedKey}[{$i}]"));
+ } else {
+ \array_push($result, ["{$calculatedKey}[{$i}]", $elem]);
+ }
+ }
+
+ return $result;
+ }
+
+ /**
+ * @param string $key a string to URL-encode
+ *
+ * @return string the URL-encoded string
+ */
+ public static function urlEncode($key)
+ {
+ $s = \urlencode((string) $key);
+
+ // Don't use strict form encoding by changing the square bracket control
+ // characters back to their literals. This is fine by the server, and
+ // makes these parameter strings easier to read.
+ $s = \str_replace('%5B', '[', $s);
+
+ return \str_replace('%5D', ']', $s);
+ }
+
+ public static function normalizeId($id)
+ {
+ if (\is_array($id)) {
+ $params = $id;
+ $id = $params['id'];
+ unset($params['id']);
+ } else {
+ $params = [];
+ }
+
+ return [$id, $params];
+ }
+
+ /**
+ * Returns UNIX timestamp in milliseconds.
+ *
+ * @return int current time in millis
+ */
+ public static function currentTimeMillis()
+ {
+ return (int) \round(\microtime(true) * 1000);
+ }
+}