Configuración de la Región de AWS para la versión 3 de AWS SDK para PHP - 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 de la Región de AWS para la versión 3 de AWS SDK para PHP

Los clientes del SDK se conectan a un Servicio de AWS en una Región de AWS específica que usted especifica al crear el cliente. Esta configuración permite que la aplicación interactúe con recursos de AWS 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 versión 3 de AWS SDK para PHP 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. Archivos de configuración de AWS; si no se ha establecido ninguna variable de entorno regional, el SDK comprueba los archivos de configuración de AWS:

    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 regiones en la versión 3 de AWS SDK para PHP:

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 la aplicación necesita funcionar en varios entornos de AWS, considere la posibilidad de utilizar diferentes perfiles en el archivo config de AWS y cambiar de uno a otro según sea necesario.