ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / shotlining / public_html / wp-content / plugins / w3-total-cache / vendor / aws / aws-sdk-php / src

<?php

namespace Aws;

use Aws\Credentials\CredentialsInterface;
use Aws\Credentials\CredentialSources;

/**
 * A placeholder for gathering metrics in a request.
 *
 * @internal
 */
final class MetricsBuilder
{
    const WAITER = "B";
    const PAGINATOR = "C";
    const RETRY_MODE_LEGACY = "D";
    const RETRY_MODE_STANDARD = "E";
    const RETRY_MODE_ADAPTIVE = "F";
    const S3_TRANSFER = "G";
    const S3_CRYPTO_V1N = "H";
    const S3_CRYPTO_V2 = "I";
    const S3_EXPRESS_BUCKET = "J";
    const GZIP_REQUEST_COMPRESSION = "L";
    const ENDPOINT_OVERRIDE = "N";
    const ACCOUNT_ID_ENDPOINT = "O";
    const ACCOUNT_ID_MODE_PREFERRED = "P";
    const ACCOUNT_ID_MODE_DISABLED = "Q";
    const ACCOUNT_ID_MODE_REQUIRED = "R";
    const SIGV4A_SIGNING = "S";
    const RESOLVED_ACCOUNT_ID = "T";
    const FLEXIBLE_CHECKSUMS_REQ_CRC32 = "U";
    const FLEXIBLE_CHECKSUMS_REQ_CRC32C = "V";
    const FLEXIBLE_CHECKSUMS_REQ_CRC64 = "W";
    const FLEXIBLE_CHECKSUMS_REQ_SHA1 = "X";
    const FLEXIBLE_CHECKSUMS_REQ_SHA256 = "Y";
    const CREDENTIALS_CODE = "e";
    const CREDENTIALS_ENV_VARS = "g";
    const CREDENTIALS_ENV_VARS_STS_WEB_ID_TOKEN = "h";
    const CREDENTIALS_STS_ASSUME_ROLE = "i";
    const CREDENTIALS_STS_ASSUME_ROLE_WEB_ID = "k";
    const CREDENTIALS_PROFILE = "n";
    const CREDENTIALS_PROFILE_STS_WEB_ID_TOKEN = "q";
    const CREDENTIALS_HTTP = "z";
    const CREDENTIALS_IMDS = "0";
    const CREDENTIALS_PROFILE_PROCESS = "v";
    const CREDENTIALS_PROFILE_SSO = "r";
    const CREDENTIALS_PROFILE_SSO_LEGACY = "t";

/** @var int */
    private static $MAX_METRICS_SIZE = 1024; // 1KB or 1024 B

/** @var string */
    private static $METRIC_SEPARATOR = ",";

/** @var array $metrics */
    private $metrics;

/** @var int $metricsSize */
    private $metricsSize;

public function __construct()
    {
        $this->metrics = [];
        // The first metrics does not include the separator
        // therefore it is reduced by default.
        $this->metricsSize = -(strlen(self::$METRIC_SEPARATOR));
    }

/**
     * Build the metrics string value.
     *
     * @return string
     */
    public function build(): string
    {
        if (empty($this->metrics)) {
            return "";
        }

return $this->encode();
    }

/**
     * Encodes the metrics by separating each metric
     * with a comma. Example: for the metrics[A,B,C] then
     * the output would be "A,B,C".
     *
     * @return string
     */
    private function encode(): string
    {
        return implode(self::$METRIC_SEPARATOR, array_keys($this->metrics));
    }

/**
     * Appends a metric to the internal metrics holder after validating it.
     * Increases the current metrics size by the length of the new metric
     * plus the length of the encoding separator.
     * Example: $currentSize = $currentSize + len($newMetric) + len($separator)
     *
     * @param string $metric The metric to append.
     *
     * @return void
     */
    public function append(string $metric): void
    {
        if (!$this->canMetricBeAppended($metric)) {
            return;
        }

$this->metrics[$metric] = true;
        $this->metricsSize += strlen($metric) + strlen(self::$METRIC_SEPARATOR);
    }

/**
     * Receives a feature group and a value to identify which one is the metric.
     * For example, a group could be `signature` and a value could be `v4a`,
     * then the metric will be `SIGV4A_SIGNING`.
     *
     * @param string $featureGroup the feature group such as `signature`.
     * @param mixed $value the value for identifying the metric.
     *
     * @return void
     */
    public function identifyMetricByValueAndAppend(
        string $featureGroup,
        $value
    ): void
    {
        if (empty($value)) {
            return;
        }

static $appendMetricFns = [
            'signature' => 'appendSignatureMetric',
            'request_compression' => 'appendRequestCompressionMetric',
            'request_checksum' => 'appendRequestChecksumMetric',
            'credentials' => 'appendCredentialsMetric'
        ];

$fn = $appendMetricFns[$featureGroup];
        $this->{$fn}($value);
    }

/**
     * Appends the signature metric based on the signature value.
     *
     * @param string $signature
     *
     * @return void
     */
    private function appendSignatureMetric(string $signature): void
    {
        if ($signature === 'v4-s3express') {
            $this->append(MetricsBuilder::S3_EXPRESS_BUCKET);
        } elseif ($signature === 'v4a') {
            $this->append(MetricsBuilder::SIGV4A_SIGNING);
        }
    }

/**
     * Appends the request compression metric based on the format resolved.
     *
     * @param string $format
     *
     * @return void
     */
    private function appendRequestCompressionMetric(string $format): void
    {
        if ($format === 'gzip') {
            $this->append(MetricsBuilder::GZIP_REQUEST_COMPRESSION);
        }
    }

/**
     * Appends the request checksum metric based on the algorithm.
     *
     * @param string $algorithm
     *
     * @return void
     */
    private function appendRequestChecksumMetric(string $algorithm): void
    {
        if ($algorithm === 'crc32') {
            $this->append(MetricsBuilder::FLEXIBLE_CHECKSUMS_REQ_CRC32);
        } elseif ($algorithm === 'crc32c') {
            $this->append(MetricsBuilder::FLEXIBLE_CHECKSUMS_REQ_CRC32C);
        } elseif ($algorithm === 'crc64') {
            $this->append(MetricsBuilder::FLEXIBLE_CHECKSUMS_REQ_CRC64);
        } elseif ($algorithm === 'sha1') {
            $this->append(MetricsBuilder::FLEXIBLE_CHECKSUMS_REQ_SHA1);
        } elseif ($algorithm === 'sha256') {
            $this->append(MetricsBuilder::FLEXIBLE_CHECKSUMS_REQ_SHA256);
        }
    }

/**
     * Appends the credentials metric based on the type of credentials
     * resolved.
     *
     * @param CredentialsInterface $credentials
     *
     * @return void
     */
    private function appendCredentialsMetric(
        CredentialsInterface $credentials
    ): void
    {
        $source = $credentials->toArray()['source'] ?? null;
        if (empty($source)) {
            return;
        }

static $credentialsMetricMapping = [
            CredentialSources::STATIC =>
                MetricsBuilder::CREDENTIALS_CODE,
            CredentialSources::ENVIRONMENT =>
                MetricsBuilder::CREDENTIALS_ENV_VARS,
            CredentialSources::ENVIRONMENT_STS_WEB_ID_TOKEN =>
                MetricsBuilder::CREDENTIALS_ENV_VARS_STS_WEB_ID_TOKEN,
            CredentialSources::STS_ASSUME_ROLE =>
                MetricsBuilder::CREDENTIALS_STS_ASSUME_ROLE,
            CredentialSources::STS_WEB_ID_TOKEN =>
                MetricsBuilder::CREDENTIALS_STS_ASSUME_ROLE_WEB_ID,
            CredentialSources::PROFILE =>
                MetricsBuilder::CREDENTIALS_PROFILE,
            CredentialSources::IMDS =>
                MetricsBuilder::CREDENTIALS_IMDS,
            CredentialSources::ECS =>
                MetricsBuilder::CREDENTIALS_HTTP,
            CredentialSources::PROFILE_STS_WEB_ID_TOKEN =>
                MetricsBuilder::CREDENTIALS_PROFILE_STS_WEB_ID_TOKEN,
            CredentialSources::PROFILE_PROCESS =>
                MetricsBuilder::CREDENTIALS_PROFILE_PROCESS,
            CredentialSources::PROFILE_SSO =>
                MetricsBuilder::CREDENTIALS_PROFILE_SSO,
            CredentialSources::PROFILE_SSO_LEGACY =>
                MetricsBuilder::CREDENTIALS_PROFILE_SSO_LEGACY,
        ];
        if (isset($credentialsMetricMapping[$source])) {
            $this->append($credentialsMetricMapping[$source]);
        }
    }

/**
     * Validates if a metric can be appended by ensuring the total size,
     * including the new metric and separator, does not exceed the limit.
     * Also checks that the metric does not already exist.
     * Example: Appendable if:
     *  $currentSize + len($newMetric) + len($separator) <= MAX_SIZE
     *  and:
     * $newMetric not in $existingMetrics
     *
     * @param string $newMetric The metric to validate.
     *
     * @return bool True if the metric can be appended, false otherwise.
     */
    private function canMetricBeAppended(string $newMetric): bool
    {
        if ($newMetric === "") {
            return false;
        }

if ($this->metricsSize
            + (strlen($newMetric) + strlen(self::$METRIC_SEPARATOR))
            > self::$MAX_METRICS_SIZE
        ) {
            return false;
        }

if (isset($this->metrics[$newMetric])) {
            return false;
        }

return true;
    }

/**
     * Returns the metrics builder from the property @context of a command.
     *
     * @param Command $command
     *
     * @return MetricsBuilder
     */
    public static function fromCommand(CommandInterface $command): MetricsBuilder
    {
        return $command->getMetricsBuilder();
    }

/**
     * Helper method for appending a metrics capture middleware into a
     * handler stack given. The middleware appended here is on top of the
     * build step.
     *
     * @param HandlerList $handlerList
     * @param $metric
     *
     * @return void
     */
    public static function appendMetricsCaptureMiddleware(
        HandlerList $handlerList,
        $metric
    ): void
    {
        $handlerList->appendBuild(
            Middleware::tap(
                function (CommandInterface $command) use ($metric) {
                    self::fromCommand($command)->append(
                        $metric
                    );
                }
            ),
            'metrics-capture-'.$metric
        );
    }
}

[+] ..
[+] Pinpoint
[+] Chime
[+] WellArchitected
[+] Health
[-] IdempotencyTokenMiddleware.php [edit]
[+] Handler
[+] Ssm
[+] SecurityHub
[+] BedrockAgentRuntime
[+] EventBridge
[+] SageMakerGeospatial
[+] DefaultsMode
[+] ResourceGroupsTaggingAPI
[+] WAFV2
[+] Identity
[+] Route53
[+] Sfn
[+] Exception
[+] ivschat
[+] S3
[-] MultiRegionClient.php [edit]
[+] Route53Resolver
[+] ConnectCampaignService
[+] MigrationHubStrategyRecommendations
[+] Sns
[+] Ses
[+] WafRegional
[+] QuickSight
[+] Sts
[+] CloudFormation
[+] Route53RecoveryControlConfig
[+] WorkDocs
[+] PinpointSMSVoiceV2
[+] DeviceFarm
[+] CleanRoomsML
[+] CognitoIdentity
[+] drs
[-] Result.php [edit]
[+] Ecs
[-] ClientResolver.php [edit]
[+] DataSync
[+] EndpointV2
[+] ForecastService
[+] ConnectCases
[+] IoTThingsGraph
[+] TaxSettings
[+] Route53RecoveryReadiness
[+] AppSync
[+] Greengrass
[+] AppConfigData
[+] ChimeSDKVoice
[+] BedrockDataAutomationRuntime
[+] MWAA
[+] DSQL
[+] BCMPricingCalculator
[+] MarketplaceReporting
[+] BedrockDataAutomation
[+] signer
[+] NeptuneGraph
[+] ApplicationSignals
[+] LookoutforVision
[+] Translate
[+] PrivateNetworks
[+] CodePipeline
[+] Iot
[+] SupplyChain
[+] BackupSearch
[+] RedshiftServerless
[+] PcaConnectorAd
[+] CloudWatchRUM
[+] ApiGatewayManagementApi
[+] FraudDetector
[+] EMRServerless
[+] Comprehend
[+] LexRuntimeV2
[+] LexRuntimeService
[+] AmplifyBackend
[+] SnowDeviceManagement
[+] OAM
[+] Route53Domains
[+] Ecr
[+] Bedrock
[+] Omics
[+] PinpointSMSVoice
[+] Lightsail
[+] RAM
[+] CodeCommit
[-] CommandPool.php [edit]
[+] TimestreamWrite
[+] Schemas
[+] Pipes
[-] AwsClient.php [edit]
[+] CloudControlApi
[-] AbstractConfigurationProvider.php [edit]
[+] DatabaseMigrationService
[-] InputValidationMiddleware.php [edit]
[-] MockHandler.php [edit]
[+] ApplicationAutoScaling
[+] EMRContainers
[+] ComprehendMedical
[+] CloudFront
[+] Shield
[+] NetworkFlowMonitor
[+] WorkMail
[+] MediaConnect
[+] KinesisVideoMedia
[+] IVS
[+] ConnectWisdomService
[+] ResourceGroups
[+] CodeStarconnections
[+] LaunchWizard
[+] EKS
[+] LicenseManager
[+] SageMakerRuntime
[+] GeoRoutes
[+] AutoScaling
[+] CostExplorer
[+] VerifiedPermissions
[+] finspace
[+] Emr
[+] Panorama
[+] FMS
[-] TraceMiddleware.php [edit]
[+] NotificationsContacts
[+] Appstream
[+] BackupGateway
[-] AwsClientInterface.php [edit]
[+] MedicalImaging
[-] HasDataTrait.php [edit]
[+] Proton
[+] Notifications
[+] ServiceQuotas
[+] MarketplaceEntitlementService
[-] ResultPaginator.php [edit]
[-] QueryCompatibleInputMiddleware.php [edit]
[+] MainframeModernization
[+] OpsWorksCM
[+] CodeBuild
[+] imagebuilder
[+] ElasticTranscoder
[+] Budgets
[+] IoTSecureTunneling
[+] Route53RecoveryCluster
[+] AppMesh
[-] RetryMiddlewareV2.php [edit]
[+] Multipart
[+] IoTDeviceAdvisor
[+] Waf
[+] Polly
[+] FSx
[+] CloudFrontKeyValueStore
[+] Inspector2
[+] XRay
[-] LruArrayCache.php [edit]
[+] KinesisVideoSignalingChannels
[+] Athena
[+] ConnectCampaignsV2
[+] InspectorScan
[+] WorkMailMessageFlow
[+] AmplifyUIBuilder
[+] ApiGatewayV2
[+] PaymentCryptography
[+] EBS
[+] Billing
[+] Endpoint
[-] Waiter.php [edit]
[+] MediaLive
[+] SecretsManager
[+] LakeFormation
[+] ServerlessApplicationRepository
[+] FIS
[+] Macie2
[+] RedshiftDataAPIService
[-] MonitoringEventsInterface.php [edit]
[+] Credentials
[+] ResourceExplorer2
[+] PartnerCentralSelling
[+] MigrationHub
[+] MarketplaceCommerceAnalytics
[+] MTurk
[-] RetryMiddleware.php [edit]
[+] IoTEventsData
[+] KinesisVideoWebRTCStorage
[+] MediaStore
[+] Amplify
[+] BillingConductor
[+] Kms
[+] CognitoSync
[+] Efs
[+] WorkSpacesThinClient
[+] DAX
[+] CloudWatchLogs
[+] ChimeSDKMessaging
[+] Rekognition
[+] EKSAuth
[+] ChimeSDKIdentity
[+] RolesAnywhere
[+] CodeConnections
[+] CostOptimizationHub
[+] ForecastQueryService
[+] GeoMaps
[+] CodeStarNotifications
[+] ApplicationCostProfiler
[+] LicenseManagerUserSubscriptions
[+] StorageGateway
[-] functions.php [edit]
[+] GlueDataBrew
[+] Iam
[+] Glacier
[+] CodeGuruSecurity
[+] BCMDataExports
[+] AppRunner
[+] Batch
[+] Swf
[+] MediaTailor
[+] KendraRanking
[+] SSO
[+] PersonalizeEvents
[+] EC2InstanceConnect
[+] DataZone
[+] MediaStoreData
[+] IoTEvents
[+] PCS
[-] EndpointParameterMiddleware.php [edit]
[-] HasMonitoringEventsTrait.php [edit]
[+] SavingsPlans
[+] SSMContacts
[-] Middleware.php [edit]
[+] Rds
[+] AppTest
[+] Sqs
[+] IotDataPlane
[+] ControlTower
[+] CloudHsm
[+] CodeCatalyst
[-] RequestCompressionMiddleware.php [edit]
[+] IoTFleetWise
[+] VPCLattice
[+] Lambda
[+] FreeTier
[+] SSMIncidents
[+] MediaConvert
[+] IoTTwinMaker
[+] ImportExport
[+] SageMakerFeatureStoreRuntime
[+] DataExchange
[+] PI
[+] CodeDeploy
[+] ACMPCA
[-] CacheInterface.php [edit]
[+] Synthetics
[-] StreamRequestPayloadMiddleware.php [edit]
[+] ConnectParticipant
[+] OpsWorks
[+] DocDBElastic
[+] ElasticLoadBalancing
[+] KinesisAnalytics
[+] CloudSearch
[-] MetricsBuilder.php [edit]
[+] CloudTrail
[+] ElasticBeanstalk
[+] IoTAnalytics
[+] MarketplaceAgreement
[-] CommandInterface.php [edit]
[-] PresignUrlMiddleware.php [edit]
[+] Transfer
[+] EndpointDiscovery
[+] Backup
[+] ConfigService
[+] ManagedBlockchain
[+] Firehose
[+] SSMQuickSetup
[+] Arn
[+] PersonalizeRuntime
[+] GuardDuty
[-] Psr16CacheAdapter.php [edit]
[+] Textract
[+] KafkaConnect
[+] SimSpaceWeaver
[+] Detective
[+] GreengrassV2
[+] SsmSap
[+] Account
[+] ElasticsearchService
[+] KinesisVideo
[+] QApps
[+] AutoScalingPlans
[+] MediaPackage
[+] AuditManager
[+] TimestreamInfluxDB
[+] MediaPackageV2
[+] Redshift
[+] IoTSiteWise
[+] B2bi
[+] SupportApp
[+] ComputeOptimizer
[+] ResilienceHub
[+] Crypto
[+] ApiGateway
[+] CloudHSMV2
[+] MemoryDB
[+] ManagedGrafana
[-] JsonCompiler.php [edit]
[+] ManagedBlockchainQuery
[+] ObservabilityAdmin
[+] AppRegistry
[+] LexModelsV2
[-] AwsClientTrait.php [edit]
[+] LicenseManagerLinuxSubscriptions
[+] GroundStation
[+] MigrationHubRefactorSpaces
[+] NetworkManager
[+] Route53Profiles
[+] IVSRealTime
[+] Invoicing
[+] Support
[+] CodeGuruProfiler
[+] MachineLearning
[+] S3Tables
[+] ChimeSDKMeetings
[+] TrustedAdvisor
[+] AccessAnalyzer
[+] ServiceCatalog
[+] Ec2
[+] IoTFleetHub
[+] WorkSpacesWeb
[+] LocationService
[+] Deadline
[+] Neptune
[+] DynamoDb
[-] ResultInterface.php [edit]
[+] Appflow
[+] SnowBall
[+] EntityResolution
[+] WorkSpaces
[+] TranscribeService
[+] MQ
[+] Inspector
[-] History.php [edit]
[+] ConnectContactLens
[+] IoTJobsDataPlane
[+] KinesisVideoArchivedMedia
[+] DLM
[+] ApplicationInsights
[+] ElastiCache
[+] Configuration
[+] VoiceID
[+] SecurityLake
[+] LookoutEquipment
[-] ConfigurationProviderInterface.php [edit]
[+] Artifact
[+] ClientSideMonitoring
[+] QConnect
[+] MarketplaceMetering
[+] PaymentCryptographyData
[+] Neptunedata
[+] AppConfig
[+] ServiceDiscovery
[+] mgn
[+] NetworkMonitor
[+] CustomerProfiles
[+] Auth
[+] BedrockAgent
[+] RoboMaker
[+] MarketplaceDeployment
[+] SSOAdmin
[+] DataPipeline
[+] DevOpsGuru
[+] Repostspace
[+] Glue
[+] SageMakerMetrics
[+] LexModelBuildingService
[+] Pricing
[+] S3Outposts
[+] ChimeSDKMediaPipelines
[-] HandlerList.php [edit]
[+] ApplicationDiscoveryService
[+] RDSDataService
[+] SagemakerEdgeManager
[+] AppFabric
[+] QLDBSession
[-] Sdk.php [edit]
[+] AugmentedAIRuntime
[+] CloudSearchDomain
[+] CostandUsageReportService
[+] Personalize
[+] Api
[+] Braket
[+] DirectoryService
[+] DynamoDbStreams
[+] SesV2
[+] Retry
[+] Sms
[+] Tnb
[+] Token
[+] QBusiness
[-] HashingStream.php [edit]
[-] PhpHash.php [edit]
[+] Kinesis
[+] Script
[-] PsrCacheAdapter.php [edit]
[-] ResponseContainerInterface.php [edit]
[+] CloudWatchEvents
[+] SSOOIDC
[-] WrappedHttpHandler.php [edit]
[+] ARCZonalShift
[+] Keyspaces
[-] HashInterface.php [edit]
[-] UserAgentMiddleware.php [edit]
[+] CodeGuruReviewer
[+] Organizations
[+] OpenSearchServerless
[+] KinesisAnalyticsV2
[+] OSIS
[+] TimestreamQuery
[+] NetworkFirewall
[+] MarketplaceCatalog
[+] ElasticLoadBalancingV2
[+] PrometheusService
[+] CodeArtifact
[+] Outposts
[+] IdentityStore
[+] Cloud9
[+] FinSpaceData
[+] PinpointEmail
[+] SageMaker
[+] S3Control
[+] Chatbot
[+] OpenSearchService
[+] InternetMonitor
[+] GlobalAccelerator
[-] Command.php [edit]
[+] PcaConnectorScep
[+] Acm
[+] LookoutMetrics
[+] Scheduler
[+] ElasticInference
[+] QLDB
[+] CloudTrailData
[+] kendra
[+] data
[+] SecurityIR
[+] GeoPlaces
[+] BedrockRuntime
[+] MailManager
[-] DoctrineCacheAdapter.php [edit]
[+] MediaPackageVod
[+] RecycleBin
[+] CognitoIdentityProvider
[+] CleanRooms
[+] MigrationHubConfig
[+] CloudWatchEvidently
[+] DocDB
[+] ECRPublic
[+] Signature
[+] GameLift
[+] Connect
[+] IoTWireless
[+] Kafka
[+] CloudWatch
[+] ControlCatalog
[+] CloudDirectory
[+] SocialMessaging
[+] DirectConnect
[+] MigrationHubOrchestrator
[+] HealthLake
[+] AppIntegrationsService
[+] DirectoryServiceData