apiKey = $key; $this->headers = $headers; $this->apiBase = $base; } /** * @return array */ public function __debugInfo() { return [ 'apiKey' => $this->redactedApiKey(), 'headers' => $this->headers, 'apiBase' => $this->apiBase, ]; } /** * Unpacks an options array and merges it into the existing RequestOptions * object. * @param array|string|null $options a key => value array * * @return RequestOptions */ public function merge($options) { $other_options = self::parse($options); if ($other_options->apiKey === null) { $other_options->apiKey = $this->apiKey; } if ($other_options->apiBase === null) { $other_options->apiBase = $this->apiBase; } $other_options->headers = array_merge($this->headers, $other_options->headers); return $other_options; } /** * Discards all headers that we don't want to persist across requests. */ public function discardNonPersistentHeaders() { foreach ($this->headers as $k => $v) { if (!in_array($k, self::$HEADERS_TO_PERSIST)) { unset($this->headers[$k]); } } } /** * Unpacks an options array into an RequestOptions object * @param array|string|null $options a key => value array * * @return RequestOptions */ public static function parse($options, $strict = false) { if ($options instanceof self) { return $options; } if (is_null($options)) { return new RequestOptions(null, [], null); } if (\is_string($options)) { if ($strict) { $message = 'Do not pass a string for request options. If you want to set the ' . 'API key, pass an array like ["api_key" => ] instead.'; throw new \Telnyx\Exception\InvalidArgumentException($message); } return new RequestOptions($options, [], null); } if (\is_array($options)) { $headers = []; $key = null; $base = null; if (\array_key_exists('api_key', $options)) { $key = $options['api_key']; unset($options['api_key']); } if (\array_key_exists('idempotency_key', $options)) { $headers['Idempotency-Key'] = $options['idempotency_key']; unset($options['idempotency_key']); } if (\array_key_exists('telnyx_account', $options)) { $headers['Telnyx-Account'] = $options['telnyx_account']; unset($options['telnyx_account']); } if (\array_key_exists('telnyx_version', $options)) { $headers['Telnyx-Version'] = $options['telnyx_version']; unset($options['telnyx_version']); } if (\array_key_exists('api_base', $options)) { $base = $options['api_base']; unset($options['api_base']); } if ($strict && !empty($options)) { $message = 'Got unexpected keys in options array: ' . \implode(', ', \array_keys($options)); throw new \Telnyx\Exception\InvalidArgumentException($message); } return new RequestOptions($key, $headers, $base); } $message = 'The second argument to Telnyx API method calls is an ' . 'optional per-request apiKey, which must be a string, or ' . 'per-request options, which must be an array. (HINT: you can set ' . 'a global apiKey by "Telnyx::setApiKey()")'; throw new \Telnyx\Exception\InvalidArgumentException($message); } private function redactedApiKey() { $pieces = \explode('_', $this->apiKey, 3); $last = \array_pop($pieces); $redactedLast = \strlen($last) > 4 ? (\str_repeat('*', \strlen($last) - 4) . \substr($last, -4)) : $last; \array_push($pieces, $redactedLast); return \implode('_', $pieces); } }