Agregar una instancia de base de datos de Amazon RDS a un entorno de aplicaciones PHP - AWS Elastic Beanstalk

Agregar una instancia de base de datos de Amazon RDS a un entorno de aplicaciones PHP

Puede usar una instancia de base de datos de Amazon Relational Database Service (Amazon RDS) para almacenar los datos recopilados y modificados por la aplicación. La base de datos se puede adjuntar al entorno y administrarse con Elastic Beanstalk, o bien, crearse y administrarse de forma externa.

Si es la primera vez que utiliza Amazon RDS, añada una instancia de base de datos a un entorno de prueba con la consola de Elastic Beanstalk y asegúrese de que la aplicación puede conectarse a ella.

Para conectarse a una base de datos, agregue el controlador a la aplicación, cargue la clase del controlador en el código y cree un objeto de conexión con las propiedades de entorno proporcionadas por Elastic Beanstalk. La configuración y el código de conexión varían en función del motor de base de datos y la plataforma que utilice.

nota

Para fines de aprendizaje o entornos de prueba, puede utilizar Elastic Beanstalk para agregar una instancia de base de datos.

En entornos de producción, puede crear una instancia de base de datos fuera del entorno de Elastic Beanstalk para desacoplar los recursos del entorno de los recursos de base de datos. De esta forma, cuando termina el entorno, la instancia de base de datos no se elimina. Una instancia de base de datos externa también permite conectarse a la misma base de datos desde varios entornos y llevar a cabo implementaciones “blue/green” (azul/verde). Para obtener instrucciones, consulte Uso de Elastic Beanstalk con Amazon RDS.

Añadir una instancia de base de datos al entorno

Para agregar una instancia de base de datos al entorno

  1. Abra la consola de Elastic Beanstalk y, en la lista Regiones, seleccione su región de AWS.

  2. En el panel de navegación, elija Environments (Entornos) y, a continuación, elija el nombre del entorno en la lista.

    nota

    Si tiene muchos entornos, utilice la barra de búsqueda para filtrar la lista de entornos.

  3. En el panel de navegación, elija Configuration (Configuración).

  4. En la categoría de configuración Database (Base de datos), seleccione Edit (Editar).

  5. Seleccione un motor de base de datos y escriba el nombre de usuario y la contraseña.

  6. Seleccione Aplicar.

Se tarda alrededor de 10 minutos en añadir una instancia de base de datos. Cuando se haya completado la actualización del entorno, el nombre de host de la instancia de base de datos y otra información de conexión estarán disponibles para su aplicación mediante las siguientes propiedades de entorno

Nombre de la propiedad Descripción Valor de la propiedad

RDS_HOSTNAME

El nombre de host de la instancia de base de datos.

En la pestaña Connectivity & security (Conectividad y seguridad) de la consola de Amazon RDS: Endpoint (Punto de enlace).

RDS_PORT

El puerto en que la instancia de base de datos acepta las conexiones. El valor predeterminado varía dependiendo del motor de base de datos.

En la pestaña Connectivity & security (Conectividad y seguridad) de la consola de Amazon RDS: Port (Puerto).

RDS_DB_NAME

El nombre de la base de datos, ebdb

En la pestaña Configuration (Configuración) de la consola de Amazon RDS: DB Name (Nombre de la base de datos).

RDS_USERNAME

El nombre de usuario que ha configurado para la base de datos.

En la pestaña Configuration (Configuración) de la consola de Amazon RDS: Master username (Nombre de usuario maestro).

RDS_PASSWORD

La contraseña que ha configurado para la base de datos.

No está disponible para referencia en la consola de Amazon RDS.

Para obtener más información sobre cómo configurar una instancia de base de datos interna, consulte Añadir una base de datos al entorno de Elastic Beanstalk.

Descargar un controlador

Si desea utilizar PHP Data Objects (PDO) para conectarse a la base de datos, instale el driver que corresponda al motor de base de datos elegido.

Para obtener más información, consulte http://php.net/manual/en/pdo.installation.php.

Conexión a una base de datos con PDO o MySQLi

Puede utilizar $_SERVER[`VARIABLE`] para leer la información de conexión del entorno.

Para obtener un PDO, cree un nombre de origen de datos (DSN) a partir del host, el puerto y el nombre. Pase el DSN al constructor del PDO con el nombre de usuario y la contraseña de la base de datos.

ejemplo Conexión con una base de datos de RDS a través de PDO - MySQL

<?php $dbhost = $_SERVER['RDS_HOSTNAME']; $dbport = $_SERVER['RDS_PORT']; $dbname = $_SERVER['RDS_DB_NAME']; $charset = 'utf8' ; $dsn = "mysql:host={$dbhost};port={$dbport};dbname={$dbname};charset={$charset}"; $username = $_SERVER['RDS_USERNAME']; $password = $_SERVER['RDS_PASSWORD']; $pdo = new PDO($dsn, $username, $password); ?>

Si utiliza otros controladores, sustituya mysql por el nombre del controlador: pgsql, oci o sqlsrv.

En el caso de MySQLi, pase el nombre del host, el nombre de usuario, la contraseña, el nombre de la base de datos y el puerto al constructor mysqli.

ejemplo Conexión con una base de datos de RDS a través de mysqli_connect()

$link = new mysqli($_SERVER['RDS_HOSTNAME'], $_SERVER['RDS_USERNAME'], $_SERVER['RDS_PASSWORD'], $_SERVER['RDS_DB_NAME'], $_SERVER['RDS_PORT']);

Conexión a una base de datos con Symfony

Para Symfony versión 3.2 y posteriores, puede utilizar %env(PROPERTY_NAME)% para establecer los parámetros de base de datos en un archivo de configuración en función de las propiedades de entorno establecidas por Elastic Beanstalk.

ejemplo app/config/parameters.yml

parameters: database_driver: pdo_mysql database_host: '%env(RDS_HOSTNAME)%' database_port: '%env(RDS_PORT)%' database_name: '%env(RDS_DB_NAME)%' database_user: '%env(RDS_USERNAME)%' database_password: '%env(RDS_PASSWORD)%'

Consulte External Parameters (Symfony 3.4) para obtener más información.

Para versiones anteriores de Symfony, las variables de entorno solo están accesibles si comienzan por SYMFONY__. Esto significa que las propiedades de entorno definidas por Elastic Beanstalk no están accesibles, por lo que deberá definir expresamente sus propiedades de entorno para pasar a Symfony la información de conexión.

Para conectarse a una base de datos con Symfony 2, cree una propiedad de entorno para cada parámetro. A continuación, utilice %property.name% para obtener acceso a la variable transformada por Symfony en un archivo de configuración. Por ejemplo, a una propiedad del entorno denominada SYMFONY__DATABASE__USER se puede tener acceso como database.user.

database_user: "%database.user%"

Consulte External Parameters (Symfony 2.8) para obtener más información.