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

Puede utilizar una instancia de base de datos de Amazon Relational Database Service (Amazon RDS) para almacenar datos recopilados y modificados por su aplicación. La base de datos se puede adjuntar al entorno y administrarse con Elastic Beanstalk, o bien, crearse como desacoplada y administrarse de forma externa a través de otro servicio. En este tema se proporcionan instrucciones para crear un Amazon RDS mediante la consola de Elastic Beanstalk. La base de datos se acoplará al entorno y se administrará con Elastic Beanstalk. Para obtener más información sobre el uso de Elastic Beanstalk con Amazon RDS, consulte Añadir una base de datos al entorno de Elastic Beanstalk.

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 Regions (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. Para guardar los cambios, elija Aplicar en la parte inferior de la página.

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 donde 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 dato, 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 como referencia en la consola de Amazon RDS.

Para obtener más información sobre la configuración de una instancia de bases de datos acopladas a un entorno de Elastic Beanstalk, 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.

• MySQL – PDO_MYSQL

• PostgreSQL – PDO_PGSQL

• Oracle: PDO_OCI

• SQL Server – PDO_SQLSRV

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.