Configure an endpoint

SDK for PHP V1.0 provides multiple addressing modes for endpoints. You can obtain an endpoint based on the addressing modes in the following priority.

1. User-defined addressing mode. This mode is assigned the highest priority. In this mode, you can specify an exact endpoint.

   <?php
   
   require_once 'vendor/autoload.php';
   
   use AlibabaCloud\Client\AlibabaCloud;
   use AlibabaCloud\Client\Exception\ClientException;
   use AlibabaCloud\Client\Exception\ServerException;
   use AlibabaCloud\Ecs\Ecs;
   
   try {
       // Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured. 
       AlibabaCloud::accessKeyClient(getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'), getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET'));
       // Specify an endpoint of Elastic Compute Service (ECS) in a region.
       AlibabaCloud::addHost('Ecs', 'ecs.cn-beijing.aliyuncs.com', 'cn-beijing');
       AlibabaCloud::addHost('Ecs', 'ecs.cn-hangzhou.aliyuncs.com', 'cn-hangzhou');
       // Specify a global endpoint for ECS. If no region ID is specified, the global endpoint is used.
       AlibabaCloud::addHost('Ecs', 'ecs.cn-hangzhou.aliyuncs.com');
   
       $request = Ecs::v20140526()->describeRegions();
       $result = $request
           ->debug(true)
           ->regionId('cn-hangzhou') // Specify the region ID.
           ->host("ecs.cn-hangzhou.aliyuncs.com") // Specify the endpoint with the highest priority.
           ->request();
       print_r($result->toArray());
   } catch (ClientException $exception) {
       // Handle exceptions with caution in actual business scenarios and never ignore exceptions in your project. In this example, the information is displayed for reference only. 
       echo $exception->getMessage() . PHP_EOL;
   } catch (ServerException $exception) {
       // Handle exceptions with caution in actual business scenarios and never ignore exceptions in your project. In this example, the information is displayed for reference only. 
       echo $exception->getMessage() . PHP_EOL;
       echo $exception->getErrorCode() . PHP_EOL;
       echo $exception->getRequestId() . PHP_EOL;
       echo $exception->getErrorMessage() . PHP_EOL;
   }

2. Cloud service SDK-based addressing mode. In this mode, you can obtain the endpoint based on the endpoint.json file of a cloud service, such as ECS.

3. Core library-based addressing mode. In this mode, an endpoint is obtained based on the Data.php data file in the core library. For more information about the data file, visit Data.php.

4. Addressing by calling the location-based service API.