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

Muchas opciones de configuración se pueden gestionar fuera del código. La mayoría de las opciones de configuración se pueden establecer como variables de entorno o en un archivo config de AWS compartido independiente. El archivo config compartido de AWS puede mantener conjuntos de opciones independientes, denominados perfiles, para proporcionar diferentes configuraciones para distintos entornos o pruebas. Para obtener información detallada sobre los archivos config y credentials compartidos de AWS, consulte la Guía de referencia de los SDK y las herramientas de AWS.

La mayoría de las variables de entorno y la configuración del archivo config compartido están estandarizadas y se comparten entre los SDK y las herramientas de AWS para garantizar una funcionalidad coherente en los diferentes lenguajes de programación y aplicaciones.

Para ver toda la configuración que el SDK puede resolver a partir de las variables de entorno o los archivos de configuración, consulte Referencia de configuración en la Guía de referencia de los SDK y las herramientas de AWS.

Cadena de proveedores de configuración para la configuración del cliente

El SDK busca los valores de configuración en varios lugares (u orígenes).

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

Creación de un cliente de servicio configurado mediante opciones externas

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

Creación de un cliente de servicio que utiliza un constructor sin parámetros

Si toda la configuración de configuración que necesita proviene de orígenes externos, puede crear un cliente de servicio mediante el uso de un constructor vacío:

require 'vendor/autoload.php';

use Aws\S3\S3Client;

$s3 = new S3Client([]);

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

La cadena de proveedores de Región de AWS 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 resolver la Región de AWS que se utilizará y encontrar la configuración que le permita recuperar las credenciales para firmar las solicitudes. Si el SDK no encuentra esos valores, se produce un error en la creación del cliente.

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

Más allá de la configuración entre sdk compatible con la mayoría de los SDK de AWS, la versión 3 de AWS SDK para PHP funciona con las siguientes variables de entorno: