Configuración externa de clientes de servicio para la AWS SDK para PHP versión 3 - AWS SDK para PHP
Cadena de proveedores de configuración para la configuración de los clientesCree un cliente de servicio configurado con parámetros externosAWS SDK para PHP Variables de entorno de la versión 3

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 externa de clientes de servicio para la AWS SDK para PHP versión 3

Muchos ajustes de configuración se pueden gestionar fuera del código. La mayoría de los ajustes de configuración se pueden establecer como variables de entorno o en un AWS config archivo compartido independiente. El config archivo AWS compartido puede mantener conjuntos de ajustes separados, denominados perfiles, para proporcionar diferentes configuraciones para diferentes entornos o pruebas. Para obtener un análisis completo de lo AWS compartido config y de credentials los archivos, consulte la AWS SDKs Guía de referencia de herramientas.

La mayoría de las variables de entorno y la configuración de los config archivos compartidos están estandarizadas y se comparten entre sí, AWS SDKs y son herramientas que permiten una funcionalidad uniforme en los diferentes lenguajes de programación y aplicaciones.

Para ver todos los ajustes que el SDK puede resolver a partir de las variables de entorno o los archivos de configuración, consulta la referencia sobre los ajustes en la Guía de referencia de herramientas AWS SDKs y las herramientas.

Cadena de proveedores de configuración para la configuración de los clientes

El SDK busca valores de configuración en varios lugares (o fuentes).

  1. Cualquier ajuste explícito establecido en el código o en el propio cliente de un servicio tiene prioridad sobre cualquier otra cosa.

  2. Variables de entorno

    • Para obtener más información sobre la configuración de las variables de entorno, consulte las variables de entorno en la Guía de referencia de herramientas AWS SDKs y herramientas.

    • Tenga en cuenta que puede configurar las variables de entorno para un shell en diferentes niveles de alcance: en todo el sistema, en todo el usuario y para una sesión de terminal específica.

  3. Archivos config y credentials compartidos

  4. Los valores predeterminados proporcionados por el propio código fuente del SDK se utilizan en último lugar.

    • Algunas propiedades, como la región, no tienen un valor predeterminado. Debe especificarlas de forma explícita en el código, en una configuración de entorno o en el config archivo compartido. Si el SDK no puede resolver la configuración requerida, las solicitudes de API pueden fallar en tiempo de ejecución.

Además de esta cadena de configuración general, la AWS SDK para PHP versión 3 también utiliza cadenas de proveedores especializadas, que incluyen la cadena de proveedores de credenciales y la cadena de Región de AWS resolución. Estas cadenas especializadas añaden proveedores adicionales que tienen en cuenta el entorno en el que se ejecuta el SDK. Por ejemplo, en un contenedor o una EC2 instancia.

Cree un cliente de servicio configurado con parámetros externos

Necesita crear un cliente de servicio en su aplicación para comunicarse con un Servicio de AWS. Los clientes de servicio son su conexión esencial Servicios de AWS, ya que se encargan de todos los detalles complejos de la comunicación para que no tenga que preocuparse por ellos. Se encargan de tareas importantes, como la seguridad y la gestión de errores, y los reintentan automáticamente, lo que le permite centrarse en crear su aplicación en lugar de en ocuparse de las complicaciones técnicas.

Cree un cliente de servicio utilizando un constructor sin parámetros

Si todos los ajustes de configuración que necesita provienen de fuentes externas, puede crear un cliente de servicio mediante un constructor vacío:

require 'vendor/autoload.php';

use Aws\S3\S3Client;

$s3 = new S3Client([]);

El fragmento de código anterior crea una S3Client instancia. Durante la creación, el SDK busca ajustes en la cadena de proveedores de configuración. Una vez que el SDK encuentra un valor de configuración, lo utiliza.

La cadena Región de AWS de proveedores predeterminada y la cadena de proveedores de credenciales predeterminada también se utilizarán en el proceso de creación. En algún punto de la cadena, el SDK debe Región de AWS resolver los ajustes de uso y búsqueda que le permitan recuperar las credenciales para las solicitudes de firma. Si los SDKs archivos buscan esos valores, se produce un error al crear el cliente.

AWS SDK para PHP Variables de entorno de la versión 3

Además de la configuración entre varios SDK que admite la mayoría AWS SDKs, la AWS SDK para PHP versión 3 funciona con las siguientes variables de entorno:

AWS_SDK_LOAD_NONDEFAULT_CONFIG

Cuando se establece, esta variable de entorno indica al SDK que cargue las credenciales de los AWS config archivos además de los archivos. ~/.aws/config credentials ~/.aws/credential

AWS_SDK_UA_APP_ID

Establece un identificador de aplicación personalizado que se incluye en el encabezado user-Agent para las solicitudes realizadas por el SDK.

AWS_SUPPRESS_PHP_DEPRECATION_WARNING

Si se establece en true, suprime las advertencias de obsolescencia de PHP que pueda generar el SDK.