$data, 'original exception' => $ex]), $ex ); } return $serializedData; } /** * @param string $name * @param null|bool|int|float|string|JsonSerializable|stdClass|array $value * @param array $nameToValue * * @return void */ private static function assertNotExists(string $name, $value, array $nameToValue): void { if (self::$isInTestingContext && array_key_exists($name, $nameToValue)) { throw new SerializationException( ExceptionUtil::buildMessage( 'Given key already exists in given array', ['name' => $name, 'value' => $value, 'nameToValue' => $nameToValue] ) ); } } /** * @param string $name * @param bool|int|float|string|JsonSerializable|stdClass|array $value * @param array $nameToValue * * @return void */ public static function addNameValue(string $name, $value, array &$nameToValue): void { self::assertNotExists($name, $value, $nameToValue); $nameToValue[$name] = $value; } /** * @param string $name * @param null|bool|int|float|string|JsonSerializable|stdClass|array $value * @param array $nameToValue * * @return void */ public static function addNameValueAssumeNotNull(string $name, $value, array &$nameToValue): void { /** @var bool|int|float|string|JsonSerializable|stdClass|array $value */ self::addNameValue($name, $value, /* ref */ $nameToValue); } /** * @param string $name * @param null|bool|int|float|string|JsonSerializable|stdClass|array $value * @param array $nameToValue * * @return void */ public static function addNameValueIfNotNull(string $name, $value, array &$nameToValue): void { self::assertNotExists($name, $value, $nameToValue); if ($value !== null) { $nameToValue[$name] = $value; } } /** * @param string $name * @param array|stdClass $value * @param array $nameToValue * * @return void */ public static function addNameValueIfNotEmpty(string $name, $value, array &$nameToValue): void { self::assertNotExists($name, $value, $nameToValue); if (!empty($value)) { $nameToValue[$name] = $value; } } public static function prepareForSerialization(?OptionalSerializableDataInterface &$value): int { if ($value === null) { return BoolUtil::INT_FOR_FALSE; } if ($value->prepareForSerialization()) { return BoolUtil::INT_FOR_TRUE; } $value = null; return BoolUtil::INT_FOR_FALSE; } /** * @param float $timestamp * * @return float|int */ public static function adaptTimestamp(float $timestamp) { // If int type is large enough to hold 64-bit (8 bytes) use it instead of float return (PHP_INT_SIZE >= 8) ? intval($timestamp) : $timestamp; } /** * @param array|stdClass $nameToValue * * @return array */ public static function preProcessResult($nameToValue) { return is_array($nameToValue) ? $nameToValue : []; } /** * @param array $nameToValue * * @return array|stdClass */ public static function ensureObject(array $nameToValue) { return ArrayUtil::isEmpty($nameToValue) ? (new stdClass()) : $nameToValue; } /** * @param array $nameToValue * * @return array|stdClass */ public static function postProcessResult(array $nameToValue) { return self::ensureObject($nameToValue); } }