summaryrefslogtreecommitdiff
path: root/vendor/aws/aws-sdk-php/src/EndpointV2/Rule/EndpointRule.php
blob: b6b276d70c5bdc0fa6a007e28f8cf12c5241f31f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
<?php

namespace Aws\EndpointV2\Rule;

use Aws\EndpointV2\Ruleset\RulesetStandardLibrary;
use Aws\EndpointV2\Ruleset\RulesetEndpoint;

Class EndpointRule extends AbstractRule
{
    /** @var array */
    private $endpoint;

    public function __construct(array $definition)
    {
        parent::__construct($definition);
        $this->endpoint = $definition['endpoint'];
    }

    /**
     * @return array
     */
    public function getEndpoint()
    {
        return $this->endpoint;
    }

    /**
     * If all the rule's conditions are met, return the resolved
     * endpoint object.
     *
     * @return RulesetEndpoint | null
     */
    public function evaluate(array $inputParameters, RulesetStandardLibrary $standardLibrary)
    {
        if ($this->evaluateConditions($inputParameters, $standardLibrary)) {
            return $this->resolve($inputParameters, $standardLibrary);
        }
        return false;
    }

    /**
     * Given input parameters, resolve an endpoint in its entirety.
     *
     * @return RulesetEndpoint
     */
    private function resolve(
        array $inputParameters,
        RulesetStandardLibrary $standardLibrary
    )
    {
        $uri = $standardLibrary->resolveValue($this->endpoint['url'], $inputParameters);
        $properties = isset($this->endpoint['properties'])
                ? $this->resolveProperties($this->endpoint['properties'], $inputParameters, $standardLibrary)
                : null;
        $headers = $this->resolveHeaders($inputParameters, $standardLibrary);

        return new RulesetEndpoint($uri, $properties, $headers);
    }

    /**
     * Recurse through an endpoint's `properties` attribute, resolving template
     * strings when found. Return the fully resolved attribute.
     *
     * @return array
     */
    private function resolveProperties(
        $properties,
        array $inputParameters,
        RulesetStandardLibrary $standardLibrary
    )
    {
        if (is_array($properties)) {
           $propertiesArr = [];
           foreach($properties as $key => $val) {
               $propertiesArr[$key] = $this->resolveProperties($val, $inputParameters, $standardLibrary);
           }
           return $propertiesArr;
        } elseif ($standardLibrary->isTemplate($properties)) {
            return $standardLibrary->resolveTemplateString($properties, $inputParameters);
        }
        return $properties;
    }

    /**
     * If present, iterate through an endpoint's headers attribute resolving
     * values along the way. Return the fully resolved attribute.
     *
     * @return array
     */
    private function resolveHeaders(
        array $inputParameters,
        RulesetStandardLibrary $standardLibrary
    )
    {
        $headers = isset($this->endpoint['headers']) ? $this->endpoint['headers'] : null;
        if (is_null($headers)) {
            return null;
        }
        $resolvedHeaders = [];

        foreach($headers as $headerName => $headerValues) {
            $resolvedValues = [];
            foreach($headerValues as $value) {
                $resolvedValue = $standardLibrary->resolveValue($value, $inputParameters, $standardLibrary);
                $resolvedValues[] = $resolvedValue;
            }
            $resolvedHeaders[$headerName] = $resolvedValues;
        }
        return $resolvedHeaders;
    }
}