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 se establece explícitamente la región en las opciones del constructor del cliente, esta tendrá prioridad sobre todas las demás fuentes.

    $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 configuración: AWS

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

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

    3. Si no AWS_PROFILE se especifica, el SDK usa el perfil «predeterminado»

    Como ejemplo, supongamos que tenemos los siguientes ajustes del archivo de configuración:

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

[profile production]
region = eu-central-1

    Si la variable de AWS_PROFILE entorno se establece con un valor de «producción», los clientes utilizan eleu-central-1 Region. Si no existe ninguna variable de AWS_PROFILE entorno, los clientes utilizan la eu-west-1 región.

  4. Si el SDK no encuentra ningún valor de región en ninguna de las fuentes anteriores, genera una excepción, ya que un 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:

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

Para las aplicaciones de producción, recomendamos configurar la región de forma explícita en el código en lugar de confiar en las variables de entorno o en lasconfig. Esto hace que el código sea más predecible y dependa menos de la configuración externa.

Utilice variables de entorno para el desarrollo y las pruebas

Para los entornos de desarrollo y pruebas, el uso de variables de entorno permite una mayor flexibilidad sin cambiar el código.

Utilice perfiles para varios entornos

Si la 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.