Configuración del Región de AWS para la AWS SDK para PHP versión 3 - AWS SDK para PHP
Cadena de resolución de regionesPrácticas recomendadas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración del Región de AWS para la AWS SDK para PHP versión 3

Los clientes del SDK se conectan a un Servicio de AWS entorno específico Región de AWS que usted especifique al crear el cliente. Esta configuración permite que la aplicación interactúe con AWS los recursos de esa área geográfica. Al crear un cliente de servicio sin establecer una región de forma explícita, el SDK utiliza la región predeterminada de la configuración externa.

Cadena de resolución de regiones

La AWS SDK para PHP versión 3 utiliza el siguiente orden para determinar qué región utiliza un cliente de servicio:

  1. Región proporcionada en el código; si establece explícitamente la región en las opciones del constructor del cliente, esta tendrá prioridad sobre todos los demás orígenes.

    $s3Client = new Aws\S3\S3Client([
    'region' => 'us-west-2'
]);

  2. Variables de entorno; si no se proporciona ninguna región en el código, el SDK comprueba estas variables de entorno en el orden siguiente:

    • AWS_REGION

    • AWS_DEFAULT_REGION

    # Example of setting Region through environment variables.
export AWS_REGION=us-east-1

  3. AWS archivos de configuración: si no se ha establecido ninguna variable de entorno regional, el SDK comprueba los archivos de AWS configuración:

    1. El SDK busca en ~/.aws/config (o en la ubicación especificada por la variable de entorno AWS_CONFIG_FILE).

    2. El SDK examina la configuración regional en el perfil especificado por la variable de entorno AWS_PROFILE.

    3. Si no se especifica AWS_PROFILE, el SDK usa el perfil “default”.

    A modo de ejemplo, supongamos que tenemos las siguientes opciones del archivo de configuración:

    # Example ~/.aws/config file.
[default]
region = eu-west-1

[profile production]
region = eu-central-1

    Si la variable de entorno AWS_PROFILE se ha establecido con el valor “production”, los clientes utilizan la eu-central-1 Region. Si no existe la variable de entorno AWS_PROFILE, los clientes utilizan la región eu-west-1.

  4. Si el SDK no encuentra ningún valor de región en ninguno de los orígenes anteriores, genera una excepción, ya que el valor de región es una configuración obligatoria para un cliente de servicio.

Prácticas recomendadas

Tenga en cuenta las siguientes prácticas recomendadas al trabajar con las regiones de la AWS SDK para PHP versión 3:

Establecimiento de la región de forma explícita en el código de producción

En el caso de las aplicaciones de producción, recomendamos establecer explícitamente la región en el código en lugar de basarse en variables de entorno o en el archivo config. De este modo, el código es más predecible y menos dependiente de la configuración externa.

Uso de variables de entorno para desarrollo y pruebas

En el caso de los entornos de desarrollo y pruebas, utilizar variables de entorno ofrece mayor flexibilidad sin necesidad de cambiar el código.

Uso de perfiles para varios entornos

Si su aplicación necesita funcionar con varios AWS entornos, considere la posibilidad de utilizar diferentes perfiles en el AWS config archivo y cambiar de uno a otro según sea necesario.