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 los clientes de servicio para la AWS SDK para PHP versión 3
Muchas opciones 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 archivo config compartido de AWS
puede mantener conjuntos de opciones independientes, denominados perfiles, para proporcionar diferentes configuraciones para distintos entornos o pruebas. Para obtener un análisis completo de los credentials archivos config y elementos AWS
compartidos, consulte la AWS SDKs Guía de referencia de las 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 del cliente
El SDK busca los valores de configuración en varios lugares (u orígenes).
-
Cualquier ajuste explícito establecido en el código o en el propio cliente de un servicio tiene prioridad sobre cualquier otra cosa.
-
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 variables de entorno para un intérprete de comandos en diferentes niveles de ámbito: todo el sistema, todos los usuarios y una sesión de terminal específica.
-
-
Archivos
configycredentialscompartidos-
Para obtener más información sobre la configuración de estos archivos, consulte los
credentialsarchivos compartidosconfigy de la AWS SDKs Guía de referencia de herramientas.
-
-
Los valores predeterminados proporcionados por el código fuente del SDK se utilizan en último lugar.
-
Algunas propiedades, como la región, no tienen un valor predeterminado. Debe especificarlas explícitamente en el código, en la configuración del entorno o en el archivo
configcompartido. Si el SDK no puede resolver la configuración requerida, las solicitudes de la API pueden generar errores 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 especializados, que incluyen la cadena de proveedores de credenciales y la cadena de Región de AWS resolución. 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 de 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 su conexión esencial con los clientes Servicios de AWS, ya que gestionan todos los detalles complejos de la comunicación para que usted no tenga que preocuparse por 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 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 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.
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 del AWS
configarchivo (~/.aws/config) además de los archivos.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_DEPRECIATION_WARNING
-
Cuando se establece en true, suprime las advertencias de obsolescencia de PHP que el SDK podría generar.