EC2Service.php

<?php
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0

// snippet-start:[php.example_code.ec2.service.Ec2Service]

namespace Ec2;

use Aws\Ec2\Ec2Client;
use Aws\Ec2\Exception\Ec2Exception;

class EC2Service
{
    protected Ec2Client $ec2Client;
    protected string $region;

    public function getRegion(): string
    {
        return $this->region;
    }

    public function __construct($client = null, $region = 'us-west-2', $version = 'latest', $profile = 'default')
    {
        if (gettype($client) == Ec2Client::class) {
            $this->ec2Client = $client;
            return;
        }
        $this->ec2Client = new Ec2Client([
            'region' => $region,
            'version' => $version,
            'profile' => $profile,
        ]);
        $this->region = $region;
        /* Inline declaration example
        // snippet-start:[php.example_code.ec2.basics.createClient]
        $ec2Client = new Ec2Client(['region' => 'us-west-2', 'version' => 'latest', 'profile' => 'default']);
        // snippet-end:[php.example_code.ec2.basics.createClient]
        */
    }

    // snippet-start:[php.example_code.ec2.service.createVpcEndpoint]

    /**
     * @param string $serviceName
     * @param string $vpcId
     * @param array $routeTableIds
     * @return array
     */
    public function createVpcEndpoint(string $serviceName, string $vpcId, array $routeTableIds): array
    {
        try {
            $result = $this->ec2Client->createVpcEndpoint([
                'ServiceName' => $serviceName,
                'VpcId' => $vpcId,
                'RouteTableIds' => $routeTableIds,
            ]);

            return $result["VpcEndpoint"];
        } catch(Ec2Exception $caught){
            echo "There was a problem creating the VPC Endpoint: {$caught->getAwsErrorMessage()}\n";
            throw $caught;
        }
    }

    // snippet-end:[php.example_code.ec2.service.createVpcEndpoint]

    // snippet-start:[php.example_code.ec2.service.createVpc]

    /**
     * @param string $cidr
     * @return array
     */
    public function createVpc(string $cidr): array
    {
        try {
            $result = $this->ec2Client->createVpc([
                "CidrBlock" => $cidr,
            ]);
            return $result['Vpc'];
        }catch(Ec2Exception $caught){
            echo "There was a problem creating the VPC: {$caught->getAwsErrorMessage()}\n";
            throw $caught;
        }
    }

    // snippet-end:[php.example_code.ec2.service.createVpc]

    // snippet-start:[php.example_code.ec2.service.deleteVpc]

    /**
     * @param string $vpcId
     * @return void
     */
    public function deleteVpc(string $vpcId)
    {
        try {
            $this->ec2Client->deleteVpc([
                "VpcId" => $vpcId,
            ]);
        }catch(Ec2Exception $caught){
            echo "There was a problem deleting the VPC: {$caught->getAwsErrorMessage()}\n";
            throw $caught;
        }
    }

    // snippet-end:[php.example_code.ec2.service.deleteVpc]

    // snippet-start:[php.example_code.ec2.service.deleteVpcEndpoint]

    /**
     * @param string $vpcEndpointId
     * @return void
     */
    public function deleteVpcEndpoint(string $vpcEndpointId)
    {
        try {
            $this->ec2Client->deleteVpcEndpoints([
                "VpcEndpointIds" => [$vpcEndpointId],
            ]);
        }catch (Ec2Exception $caught){
            echo "There was a problem deleting the VPC Endpoint: {$caught->getAwsErrorMessage()}\n";
            throw $caught;
        }
    }

    // snippet-end:[php.example_code.ec2.service.deleteVpcEndpoint]

    // snippet-start:[php.example_code.ec2.service.describeRouteTables]

    /**
     * @param array $routeTableIds
     * @param array $filters
     * @return array
     */
    public function describeRouteTables(array $routeTableIds = [], array $filters = []): array
    {
        $parameters = [];
        if($routeTableIds){
            $parameters['RouteTableIds'] = $routeTableIds;
        }
        if($filters){
            $parameters['Filters'] = $filters;
        }
        try {
            $paginator = $this->ec2Client->getPaginator("DescribeRouteTables", $parameters);
            $contents = [];
            foreach ($paginator as $result) {
                foreach ($result['RouteTables'] as $object) {
                    $contents[] = $object['RouteTableId'];
                }
            }
        }catch (Ec2Exception $caught){
            echo "There was a problem paginating the results of DescribeRouteTables: {$caught->getAwsErrorMessage()}\n";
            throw $caught;
        }
        return $contents;
    }

    // snippet-end:[php.example_code.ec2.service.describeRouteTables]

    // snippet-start:[php.example_code.ec2.service.waitForVpcAvailable]

    /**
     * @param string $VpcId
     * @return void
     */
    public function waitForVpcAvailable(string $VpcId): void
    {
        try {
            $waiter = $this->ec2Client->getWaiter("VpcAvailable", [
                'VpcIds' => [$VpcId],
            ]);

            $promise = $waiter->promise();
            $promise->wait();
        }catch(Ec2Exception $caught){
            echo "There was a problem waiting for the VPC: {$caught->getAwsErrorMessage()}\n";
            throw $caught;
        }
    }

    // snippet-end:[php.example_code.ec2.service.waitForVpcAvailable]
}

// snippet-end:[php.example_code.ec2.service.Ec2Service]