¿Cómo Configurar Variables de Entorno para PHP en Apache?

Configurar Variables de Entorno en Apache

Apache ofrece la directiva SetEnv para establecer variables de entorno en aplicaciones PHP. Esta directiva te permite definir variables personalizadas en tus archivos de configuración de Apache. La sintaxis básica es: SetEnv NOMBRE_VARIABLE valor. Puedes usar esta directiva para establecer las variables de entorno que necesite tu aplicación PHP.

Configurar Variables de Entorno Específicas por Dominio

Apache usa bloques VirtualHost para gestionar configuraciones de diferentes dominios. Estos bloques te permiten establecer configuraciones específicas para cada sitio web en tu servidor. Para configurar diferentes variables de entorno para cada dominio, añade las directivas SetEnv dentro del bloque VirtualHost apropiado.

Aquí tienes un ejemplo de cómo configurar variables de entorno para dos dominios en tu configuración de Apache:

<VirtualHost *:80>
    ServerName ejemplo1.com
    DocumentRoot /var/www/ejemplo1
    SetEnv DB_HOST localhost
    SetEnv DB_NAME ejemplo1_db
</VirtualHost>

<VirtualHost *:80>
    ServerName ejemplo2.com
    DocumentRoot /var/www/ejemplo2
    SetEnv DB_HOST 192.168.1.100
    SetEnv DB_NAME ejemplo2_db
</VirtualHost>

Esta configuración establece diferentes variables DB_HOST y DB_NAME para ejemplo1.com y ejemplo2.com. Tu aplicación PHP puede acceder a estas variables usando la función getenv().

<?php
$dbHost = getenv('DB_HOST');
$dbName = getenv('DB_NAME');

$db = new PDO("mysql:host=$dbHost;dbname=$dbName", $username, $password);
?>

Localizar y Editar Archivos de Configuración de Apache

Para configurar variables de entorno en Apache, necesitas encontrar y editar el archivo de configuración. En la mayoría de sistemas Linux, el archivo de configuración principal de Apache está en /etc/apache2/apache2.conf o /etc/httpd/httpd.conf. A menudo es mejor usar archivos de configuración separados para cada virtual host.

Estos archivos suelen estar en /etc/apache2/sites-available/ o /etc/httpd/conf.d/. Busca archivos nombrados según tu dominio o con extensión .conf.

Para editar estos archivos de forma segura:

1. Haz una copia de seguridad del archivo original:

   sudo cp /etc/apache2/sites-available/tu-sitio.conf /etc/apache2/sites-available/tu-sitio.conf.bak

2. Abre el archivo con un editor de texto usando sudo:

   sudo nano /etc/apache2/sites-available/tu-sitio.conf

ls -l /etc/apache2/sites-available/tu-sitio.conf

Añadir Variables de Entorno a los Bloques VirtualHost

Para añadir variables de entorno, usa la directiva SetEnv dentro del bloque VirtualHost de tu dominio. Aquí está la sintaxis básica:

<VirtualHost *:80>
    ServerName tudominio.com
    DocumentRoot /var/www/tudominio
    SetEnv NOMBRE_VARIABLE valor
</VirtualHost>

Aquí tienes algunos ejemplos de configuraciones comunes de variables de entorno:

1. Detalles de conexión a la base de datos:

   SetEnv DB_HOST localhost
   SetEnv DB_NAME miapp_database
   SetEnv DB_USER miapp_user
   SetEnv DB_PASS miapp_password

2. Modo de la aplicación:

   SetEnv APP_ENV production

3. Claves API:

   SetEnv API_KEY tu_clave_api_aqui

4. Configuración personalizada de la aplicación:

   SetEnv CACHE_TIMEOUT 3600
   SetEnv DEBUG_MODE false

Añade estas directivas SetEnv dentro del bloque VirtualHost correcto para cada dominio. De esta manera, puedes tener diferentes variables de entorno para diferentes dominios en el mismo servidor.

Reiniciar Apache Para Aplicar los Cambios

Después de configurar variables de entorno en tu configuración de Apache, reinicia el servicio Apache para que los cambios surtan efecto. Usa estos comandos para reiniciar Apache:

Para sistemas Ubuntu/Debian:

sudo systemctl restart apache2

Para sistemas CentOS/RHEL:

sudo systemctl restart httpd

Antes de reiniciar, verifica que no haya errores de configuración:

sudo apache2ctl configtest

Si este comando devuelve "Syntax OK", tu configuración es correcta y puedes reiniciar.

sudo systemctl reload apache2

sudo systemctl reload httpd

Confirmar Variables de Entorno en PHP

Para verificar que tus variables de entorno están configuradas correctamente, usa funciones de PHP para comprobar sus valores:

1. Crea un archivo PHP (por ejemplo, env_test.php) en el directorio raíz de tu web con este contenido:

<?php
phpinfo();
?>

2. Accede a este archivo a través de tu navegador web. Busca la sección "Environment" en la salida. Tus variables personalizadas deberían aparecer listadas allí.

3. Para una verificación específica, usa la función getenv() en un script PHP:

<?php
echo "DB_HOST: " . getenv('DB_HOST') . "
";
echo "DB_NAME: " . getenv('DB_NAME') . "
";
?>

Si tienes problemas:

1. Revisa los registros de errores de Apache (/var/log/apache2/error.log o /var/log/httpd/error_log) en busca de errores.

2. Asegúrate de que las directivas SetEnv están en el bloque VirtualHost correcto.

3. Verifica que mod_env esté habilitado en Apache:

   apache2ctl -M | grep env

   Si no aparece en la lista, actívalo con:

   sudo a2enmod env

4. Si usas PHP-FPM, es posible que necesites pasar las variables de entorno de manera diferente. Considera usar SetEnvIf en lugar de SetEnv.

Siguiendo estos pasos, puedes configurar, verificar y solucionar problemas con las variables de entorno de tus aplicaciones PHP en Apache.